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基于 Java Web 的 应 用 开发 是 当前 软件 开发 的 主要 方向 之 一 ,很 多 高 校 的 计算 机 类 
Nae ip 作者 在 多 年 的 授课 过 程 中 发 现 ,尽管 各 出 版 社 出 版 了 大 
与 该 方向 相关 的 书籍 ,但 是 这 些 书籍 往往 存在 两 个 极端 一 一 要 么 内 容 过 于 基础 ,只 是 
ras JSP 语法 和 Servlet 的 学 习 上 ;要么 是 内 容 比 较 高 深 , 开 篇 就 是 基于 框架 
的 开发 技术 ,和 弄 得 读者 尝 头 转向 。 

从 实际 开发 的 角度 上 看 ,已 经 很 少 有 人 使 用 向 JSP 中 插入 Java 代码 的 方法 进行 
Web 应 用 程序 的 开发 了 。 基 于 Java 的 MVC 开发 ,尤其 是 基于 Struts 2 的 开发 是 软件 公 
司 采用 的 主流 技术 。 作 者 编写 本 书 的 初衷 就 是 想 弥 合 前 面 提 到 的 两 类 教材 ,使 得 初学 
利用 较 短 的 时 间 学 习 了 基本 的 JSP 语法 后 ,逐步 过 渡 到 基于 Struts 2 的 应 用 开发 中 。 为 
此 ,我 们 组 织 了 辽宁 石油 化 工大 学 具有 多 年 教学 经 验 和 软件 开发 经 验 的 教师 编写 了 这 本 
教材 。 

本 书 在 内 容 组 织 上 由 浅 入 深 、 循 序 渐进 , 共 分 13 章 。 

第 1 章 概述 了 目前 主流 的 Web 开发 技术 和 利用 MyEclipse 开发 Java Web 应 用 程序 
的 方法 。 

第 2 章 和 第 3 章 讲述 了 基本 的 JSP 技术 ,包括 JSP 语法 、JSP 内 置 对 象 \JavaBean、 
ServletJDBC 和 MVC 技术 等 内 容 。 在 讲解 这 部 分 内 容 时 ,我 们 握 弃 了 一 些 在 当前 软件 
开发 中 过 时 的 知识 ,并 在 第 3 章 结束 时 给 出 了 一 个 留言 板 程序 的 开发 例 程 ,逐步 引导 读 
者 从 最 原始 的 JSP 开发 方式 过 渡 到 基于 MVC 框架 的 开发 。 

第 4 一 12 章 详细 介绍 了 与 Struts 2 开发 有 关 的 基本 技术 。 其 中 ,第 4 章 为 Struts 2 
基础 ,讲解 了 Struts 2 应 用 开发 的 基本 步骤 和 用 户 状 态 跟踪 ;第 5 章 讲解 了 Struts 2 的 工 
作 原 理 、Action 配置 和 result 映射 等 内 容 ; 第 6 章 为 标签 库 ,讲解 了 Struts 2 提供 的 各 类 
数据 标签 .控制 标签 和 表单 标签 的 运用 ;第 7 章 为 拦截 器 ,讲解 了 拦截 器 的 工作 过 程 和 使 
用 方法 ;第 8 章 为 文件 的 上 传 和 下 载 , 讲 解 了 文件 上 传 组 件 , 重 点 介绍 文件 上 传 的 开发 步 
又 ,并 详细 介绍 基于 Struts 2 框架 的 文件 下 载 应 用 开发 :第 9 章 为 输入 验证 ,讲解 了 
Struts 2 框架 的 内 置 验证 器 的 使 用 方法 ;第 10 章 为 消息 处 理 与 国际 化 ,讲解 了 资源 文件 
的 格式 .资源 文件 的 分 类 及 资源 文件 的 加 载 顺序 ,重点 介绍 如 何在 Action 类 和 JSP 文件 
中 访问 资源 消息 ;第 11 章 为 类 型 转换 ,讲解 了 Struts 2 框架 对 类 型 转换 的 支持 ,重点 介绍 
如 何 处 理 集 合 类 型 转换 ,并 详细 介绍 自 定 义 类 型 转换 器 的 开发 步骤 ;第 12 章 为 注解 ,介绍 
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Struts 2 约定 和 利用 注解 替代 在 struts. xml 中 配置 Action、Result 和 拦截 器 的 方法 。 

第 13 章 为 整合 JQuery ,介绍 了 一 个 优秀 的 、 开 源 的 JS 库 ,重点 介绍 利用 JQuery 调 
用 Action, 实 现 AJAX 的 方法 。 

本 书 具 有 如 下 特点 。 

(1) 内 容 较 全 面 ,涵盖 了 JSP 基础 知识 和 Struts 2 Web 开发 框架 的 知识 ,是 国内 第 
一 本 将 二 者 有 机 结合 的 教材 。 

(2) 在 讲解 基本 知识 的 同时 ,注重 对 Struts 2 框架 的 剖析 ,有 利于 读者 了 解 Struts 2 
实现 的 机 理 。 

(3) 本 书 还 注重 知识 的 综合 运用 ,采用 渐进 开发 的 方法 介绍 了 一 个 完整 案例 的 设计 
过 程 。 

(4) 除 第 1 章 外 ,本 书 每 章 的 最 后 配 有 一 个 同步 训练 。 读 者 通过 完成 同步 训练 ,增加 
对 本 章 知识 的 理解 ,并 训练 自己 的 动手 能 力 。 

本 书 从 内 容 的 组 织 上 ,适合 初学 者 从 零 开始 学 习 、 进 阶 , 不 断 深入 ,循序 渐进 。 本 书 
不 仅 可 以 作为 大 学 计算 机 及 相关 专业 的 选修 课 教 材 , 也 适合 自学 者 及 网 站 开发 人 员 参 考 
使 用 。 

本 书 主要 由 辽宁 石油 化 工大 学 的 李 文 超 、 赵 新 慧 和 石 元 博 编写 , 杨 妮 妮 和 冯 锡 炜 等 
参与 了 部 分 章节 的 编写 工作 。 

在 编写 过 程 中 ,我 们 参考 了 大 量 书 籍 和 文献 资料 ,查阅 了 大 量 的 博客 文章 。 在 此 ,向 
本 书 参考 文献 的 作者 表示 衷心 的 感谢 ,向 无 私 撰写 博文 ,默默 耕耘 的 各 位 博 主 表示 衷心 
的 感谢 ,向 给 予 本 书 帮 助 的 所 有 人 士 表示 衷心 的 感谢 ,尤其 感谢 沈阳 理工 大 学 职业 应 用 
技术 学 院 的 刘 平 教授 ,他 为 本 书 的 编写 提供 了 很 多 帮助 。 

由 于 编者 水 平 有 限 , 书 中 难免 有 不 足 之 处 ,欢迎 同行 批评 指正 。 


编 者 
2013 年 5 月 
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11 Web 技 术 的 发 展 


随 着 网 络 技术 的 发 展 ,Web 技术 推陈出新 ,大 致 经 历 了 静态 文档 、 动 态 网 页 和 Web 
2.0 三 个 阶段 。 


111 静态 文档 


第 一 阶段 的 Web 是 由 静态 Web 页 面 构成 。 每 个 Web 站 点 都 有 一 个 主页 作为 进入 
站 点 的 入 口 ,站 点 中 的 每 个 页 面 都 是 利用 HTML 格式 编写 的 ,内 容 相 对 固定 ,没有 后 台 
数据 库 ,不 含 程序 ,不 可 交互 。 网 页 设计 人 员 编 写 的 是 什么 , 它 显示 的 就 是 什么 ,不 会 有 
任何 改变 。 静 态 网 页 中 包含 大 量 的 超 链接 ,通过 超 链接 允许 访问 者 从 一 个 网 页 跳 转 到 另 
一 个 网 页 ,从 一 个 Web 站 点 跳 转 到 另 一 个 Web 站 点 。Web 站 点 中 的 每 一 个 静态 网 页 都 
对 应 服务 器 上 一 个 实 实在 在 的 文件 ,都 具有 一 个 固定 的 URL, 并 且 网 页 的 URL 以 . htm、 
.html、. shtml 等 常见 形式 为 后 级 ,而 且 不 含有 *?”。 

HTTP(HyperText Transport Protocol, 超 文本 传送 协议 ) 是 Web 服务 的 通信 协议 。 
通过 HTTP 协议 ,可 以 将 Web 页 面 从 Web 服务 器 传送 到 Web 浏览 器 。 

早期 的 静态 Web 页 面 中 只 能 包含 单纯 的 文本 内 容 , 后 来 逐渐 提供 了 对 图 片 的 支持 ， 
基本 上 能 够 满足 建立 Web 站 点 的 初衷 ,能 够 实现 对 信息 资源 的 共享 。 然 而 , 随 着 互联 网 
技术 的 发 展 , 利 用 纯粹 的 静态 Web 页 面 展 现 信息 的 形式 与 网 上 信息 几何 级 增长 的 矛盾 
日 益 突出 。 人 们 淘 望 能 够 通过 将 信息 存储 在 后 台数 据 库 中 ,以 一 种 简单 的 形式 ,利用 少 
量 的 Web 页 面 实现 对 信息 的 发 布 和 维护 。 这 是 静态 页 面 无 法 实现 的 。 


112 动态 网 页 


动态 网 页 是 为 了 克服 静态 页 面 的 不 足 而 引入 的 一 种 编程 技术 。 通 过 在 传统 的 静态 
页 面 中 加 入 各 种 程序 和 逻辑 控制 ,实现 了 客户 端 和 服务 器 端 之 间 的 动态 和 个 性 化 的 交流 
与 互动 。 

需要 注意 的 是 ,不 是 在 静态 网 页 中 增加 了 Flash 动画 滚动 字幕 等 视觉 效果 之 后 就 形 
成 了 动态 网 页 。 无 论 一 个 网 页 中 是 否 包 含 动态 效果 ,只 要 其 内 容 是 通过 编程 的 方式 , 利 
用 数据 库 中 的 数据 生成 的 ,这 个 网 页 就 是 动态 网 页 。 动 态 网 页 的 扩展 名 通常 为 . jsp、 
. Php、. asp、aspx、. perl 和 . cgi 等 形式 。 
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动态 网 页 的 页 面 布局 和 视觉 效果 仍然 离 不 开 HTML 的 支持 ,但 是 由 于 采用 了 数据 
库 技术 ,使 得 动态 网 页 与 Web 服务 器 上 的 文件 并 不 是 一 一 对 应 的 。 只 有 当 Web 服务 器 
接收 到 用 户 请 求 时 , 才 通 过 运行 应 用 程序 将 用 户 所 需 的 内 容 生成 HTML 格式 后 ,返回 给 
用 户 。 因 此 ,与 静态 网 站 相 比 ,使 用 了 动态 网 页 技术 的 网 站 的 维护 工作 量 大 大 降低 。 另 
外 ,动态 网 页 提供 了 交互 功能 ,允许 网 站 实现 更 多 的 功能 .例如 用 户 权 限 控制 .电子 商务 
和 用 户 留言 等 。 


113 Web20 


Web 2.0 的 概念 是 2004 年 由 O Reilly 公司 提出 的 ,是 新 的 一 类 互联 网 应 用 的 统称 。 
Web 1.0 的 特点 是 用 户 通 过 浏览 器 来 获取 自己 感 兴趣 的 信息 ,主要 指 的 是 Web 发 展 的 
第 一 个 阶段 , 即 静 态 网 页 阶段 。 动 态 网 页 阶段 往往 被 看 做 Web 1.5 时 代 。Web 2.0 是 以 
1.0 作为 基础 设施 ,添加 了 一 个 社交 层 ,注重 的 是 用 户 的 交互 作用 。 在 Web 2.0 中 ,每 个 
网 络 用 户 既 是 网 站 内 容 的 浏览 者 ,也 是 网 站 内 容 的 创造 者 。 

Web 2.0 的 代表 网 站 包括 Facebook 和 Twitter 等 。 典 型 的 Web 2.0 应 用 包括 网 络 
社区 、 网 络 应 用 程序 .社交 网 站 .博客 和 Wiki 等 。 从 开发 角度 说 , Web 2.0 的 开发 技术 包 
括 AJAX(Asyncronous JavaScript and XML )、 提 供 资 料 订阅 的 RSS (Realy Simply 
Syndication) ,实现 内 容 混 播 的 Mashup、CSS/XML、P2P(Peer to Peer, 点 对 点 通信 ) 和 
Flash 等 。 

简单 地 说 ，Web 2. 0 使 得 人 们 能 够 更 加 方便 地 进行 信息 的 获取 、 发 布 .共享 ,能 够 以 
一 种 更 好 的 形式 实现 沟通 交流 和 群 组 讨论 。Web 2. 0 使 得 人 们 成 为 Web 社会 的 人 ,Web 
也 有 了 社会 性 ,成 为 社会 化 网 络 。 


12 常见 应 用 系统 的 体系 结构 
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C/S(Client/Server, 客 户 / 服 务 器 ) 结 构 是 基于 资源 不 对 等 , 且 为 实现 共享 而 提出 来 
的 ,也 是 2000 年 以 前 最 为 流行 的 软件 体系 结构 之 一 。C/S 体系 结构 定义 了 工作 站 如 何 
与 服务 器 相连 ,以 及 如 何 实现 将 数据 和 应 用 分 布 到 多 个 处 理 机 上 。 

如 图 1-1 所 示 ,在 C/S 体系 结构 中 ,服务 器 和 客户 机 的 地 位 是 不 平等 的 ,服务 器 在 硬 
件 配 置 、 运 算 能 力 和 存储 能 力 上 都 要 优 于 客户 机 。 因 此 .服务 器 构成 了 网 络 的 核心 ,网 络 
中 的 资源 主要 集中 在 服务 器 上 ,客户 机 通过 访问 服务 器 获得 所 需要 的 网 络 资源 。 

最 简单 的 C/S 体系 结构 的 数据 库 应 用 由 客户 应 用 程序 和 数据 库 服 务 器 程序 两 部 分 
组 成 。 服 务 器 程序 在 启动 后 ,等 待 响 应 客户 程序 随时 发 来 的 请 求 ;客户 应 用 程序 实现 了 
用 户 访问 服务 器 程序 的 操作 接口 , 当 需 要 对 数据 库 中 的 数据 进行 操作 时 ,客户 程序 自动 
地 寻找 服务 器 程序 ,并 向 其 发 出 请 求 ,服务 器 程序 根据 预定 的 规则 做 出 应 答 , 送 回 结果 。 

C/S 结构 的 优点 在 于 可 以 充分 利用 服务 器 和 客户 机 硬件 环境 的 优势 ,将 任务 合理 分 
配 到 客户 机 和 服务 器 上 来 实现 ,降低 了 系统 的 通信 开销 。 另 外 ,通过 功能 划分 ,客户 应 用 
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程序 的 开发 集中 于 数据 的 显示 和 分 析 。 服 务 器 程序 的 开发 则 关注 于 数据 的 管理 ,完成 对 
数据 库 安全 性 的 要 求 ,实现 数据 访问 并 发 性 的 控制 ,以 及 实现 对 客户 应 用 程序 的 全 局 数 
据 完整 性 规则 等 工作 。 

由 于 C/S 结构 的 系统 需要 分 别 开 发 服务 器 应 用 程序 和 客户 应 用 程序 ,因此 开发 成 本 
较 高 ,客户 端 程序 设计 复杂 ,双方 交换 的 信息 的 内 容 和 形式 比较 单一 ,软件 的 维护 和 升级 
困难 。 

传统 的 两 层 C/S 结构 是 单一 服务 器 且 以 局 域 网 为 中 心 的 ,所 以 难以 扩展 至 广域网 或 
Internet。 因 此 ,人 们 提出 了 三 层 C/S 结构 ,即将 应 用 功能 分 成 表示 层 、 功 能 层 和 数据 层 
三 部 分 ,如 图 1-2 所 示 。 表 示 层 是 应 用 的 用 户 接 口 部 分 ,位 于 客户 机 上 ,担负 着 用 户 与 应 
用 间 的 对 话 功能 。 功 能 层 负责 接收 表示 层 发 来 的 服务 请 求 , 完 成 具体 的 业务 处 理 多 辑 ， 
由 应 用 服务 器 完成 。 数 据 层 就 是 DBMS ,负责 管 理 对 数据 库 数据 的 读 / 写 。 在 有 些 应 用 
场合 ,应 用 服务 器 和 数据 库 服务 器 可 能 在 同一 台 物 理 服务 器 上 实现 。 


区 


< < 
用 户 1 用 户 2 用 户 3 用 户 4 用 户 1 用 户 2 用 户 3 
图 1-1 两 层 C/S 结 构 图 1-2 三 层 C/S 结构 
122 BS 结构 


B/S(Browser/Server, 浏 览 器 /服务 器 ) 体 系 结构 是 由 美国 微软 公司 最 早 提出 的 ,是 
随 着 Internet 的 兴起 ,对 三 层 C/S 结构 的 一 种 变化 或 者 改进 的 结构 ,如 图 1-3 所 示 。 在 这 
种 结构 中 , Web 浏览 器 实现 了 用 户 界面 和 一 少 部 分 业务 逻辑 ,例如 客户 端 验 证 等 , 绝 大 多 
数 事务 功能 仍然 是 在 服务 器 端 实现 的 。 


> 


客户 端 浏览 器 


Web 服 务 器 。 数据 库 服务 器 


客户 端 浏览 器 
图 1-3 B/S 结构 
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基于 B/S 体系 结构 的 系统 的 安装 、 修 改 和 维护 比较 简单 。 由 于 系统 安装 在 服务 器 
端 ,用 户 在 使 用 时 ,只 需要 一 台 浏 览 器 就 可 以 访问 系统 的 全 部 模块 ,因此 无 论 客户 规模 有 
多 大 ,都 不 会 增加 维护 工作 量 , 所 有 的 维护 工作 仅 需 对 服务 器 进行 ,真正 实现 了 客户 端的 
零 安装 和 零 维 护 。 

当然 ,与 C/S 结构 相 比 ,采用 B/S 体系 结构 的 应 用 系统 在 数据 查询 的 响应 速度 上 ,要 
远 远 低 于 C/S 体系 结构 。 安 全 性 问题 也 是 B/S 结构 需要 着 重 考虑 的 。 尽 管 目 前 B/S 结 
构 使 得 客户 端 和 服务 器 端 能 够 交换 的 信息 的 内 容 和 形式 多 种 多 样 ,但 是 要 想 使 得 用 户 界 
面 效 果 达 到 C/S 结构 的 程度 ,需要 程序 员 付 出 更 多 的 精力 。 

另外 ,目前 的 Web 浏览 器 种 类 众多 ,常见 的 包括 Safari、Google Chrome、Firefox 和 
IE 及 其 衍生 产品 ,这 些 产品 对 W3C 规定 的 Web 标准 支持 程度 不 同 ,或 者 对 Web 标准 基 
础 进行 了 扩充 ,导致 同样 的 Web 页 面 在 不 同 浏览 器 中 的 显示 效果 可 能 是 不 同 的 ,因此 程 
序 员 在 进行 页 面 设计 时 经 常 要 考虑 浏览 器 兼容 问题 。 
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Web 是 一 种 典型 的 分 布 式 应 用 架构 。Web 应 用 中 的 每 一 次 信息 交换 都 要 涉及 客户 
端 和 服务 器 端 两 个 层面 。 因 此 , Web 开发 技术 大 体 上 分 为 客户 端 技术 和 服务 器 端 技术 两 
大 类 。 

目前 流行 的 服务 器 端 开发 技术 包括 ASP. NET、PHP 和 JSP 三 种 。 
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ASP. NET 是 微软 公司 推出 的 新 一 代 构 建 动态 Web 应 用 程序 的 开发 平台 ,是 一 种 建立 动 
态 Web 应 用 程序 的 新 技术 ,也 是 对 ASP 技术 的 扩展 。 作 为 . NET 框架 的 一 部 分 ,ASP. NET 
提供 了 所 见 即 所 得 的 可 视 化 开发 方式 , Web 页面 设 计 人 员 可 以 通过 拖 搜 服务 器 端 控 件 来 
建立 Web 页 面 , 程 序 员 可 以 使 用 任何 . NET 兼容 的 语言 (如 C#、Visual Basic NET、J#) 
编写 业务 逻辑 代码 。 

与 JSP 和 了 PHP 相 比 ,ASP.NET 的 生产 效率 较 高 ,使 用 服务 器 控件 ,可 以 在 不 写 或 者 少 
写 代码 的 情况 下 轻松 ,快捷 地 创建 ASP. NET 网 页 和 应 用 程序 。 另 外 ,由 于 ASP. NET 应 用 
程序 采用 页 面 与 代码 相 分 离 的 技术 , 即 前 台 页 面 代码 保存 到 ASPX 文件 中 ,后 台 代 码 保 
存 到 CS 文件 中 , 当 编 译 程序 将 代码 编译 为 DLL 文件 后 ,ASP. NET 在 服务 器 上 运行 时 ,可 
以 直接 运行 编译 好 的 DLL 文件 ;并 且 .ASP. NET 采用 缓存 机 制 ,提高 了 运行 ASP. NET 的 
性 能 。 

ASP. NET 可 以 有 效 地 集成 Silverlight, 能 够 开发 出 具有 专业 图 形 、 音 频 和 视频 的 
Web 应 用 程序 ,增强 了 用 户 体验 。 在 ASP. NET 开发 过 程 中 ,可 以 利用 LINQ(Language 
Integrated Query ,语言 集成 查询 ) 编 写 C# 或 者 Visual Basic 代码 ,以 查询 数据 库 相 同 的 
方式 操作 内 存 数据 ,解决 信息 整合 的 难度 。 

由 于 ASP. NET 只 能 运行 在 微软 的 平台 上 ,因此 在 开发 和 部 署 Web 应 用 程序 时 ,服务 
器 的 操作 系统 通常 为 Windows Server。Web 服务 器 采用 微软 的 IIS(Internet Information 
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Service ,Internet 信息 服务 ) ,数据 库 平台 多 采用 Microsoft SQL Server。 

ASP.NET 最 大 的 缺陷 是 必须 运行 于 IIS 之 上 ,这 是 个 曾 无 数 次 遭受 攻击 的 系统 ,由 
于 其 臭名 昭著 的 安全 性 问题 ,使 得 很 多 IT 专业 人 士 拒绝 将 他 们 的 网 络 暴露 于 IIS Web 
服务 器 之 下 。 
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PHP(HyperText Preprocessor, 超 文本 预 处 理 语言 ) 是 一 种 服务 器 端 跨 平台 、 
HTML 艇 入 式 的 脚本 语言 。 其 独特 的 语法 混合 了 C 语言 .Java 语言 和 Perl 语言 的 特点 ， 
是 一 种 被 广泛 应 用 的 开源 式 多 用 途 脚本 语言 ,尤其 适合 Web 开发 。 

采用 PHP 开发 Web 应 用 程序 时 ,服务 器 的 操作 系统 一 般 使 用 Linux, Web 服务 器 可 
以 采用 Apache, 数 据 库 多 采用 平台 MySQL。Linux、Apache 和 MySQL 均 为 免费 ,开源 
软件 ,PHP 十 Linux 十 MySQL 已 经 成 为 Web 开发 中 的 “黄金 组 合 ”, 这 种 框架 结构 可 以 为 
网 站 经 营 者 节省 很 大 一 笔 开 支 。 

目前 在 互联 网 中 ,有 很 多 网 站 的 开发 都 是 通过 PHP 语言 来 完成 的 ,例如 百度 、 雅 虎 、 
Google、YouTube、Digg 等 。 在 这 些 知 名 网 站 的 创作 开发 中 都 应 用 到 了 PHP 语言 。 

但 是 ,PHP 缺乏 规模 支持 以 及 缺乏 多 层 结构 支持 ,因此 不 适合 应 用 于 大 型 电子 商务 
站 点 ,而 更 适合 一 些小 型 的 商业 站 点 。 


133 JSP 技 术 


JSP(Java Server Page,Java 服务 嚣 页面) 技术 是 一 种 动态 网 页 技术 标准 。 在 传统 的 
网 页 HTML ,文件 中 加 入 Java 程序 片段 (Scriptlet) 和 JSP 标签 ,就 构成 了 JSP 网 页 。 

JSP 具备 了 Java 技术 的 简单 易 用 ,完全 地 面向 对 象 , 具 有 平台 无 关 性 且 安 全 可 靠 , 主 
要 面向 互联 网 的 所 有 特点 。Java Servlet 是 JSP 的 技术 基础 ,早期 的 大 型 Web 应 用 程序 
的 开发 需要 Java Servlet 和 JSP 配合 才能 完成 。 

JSP 的 优势 在 于 一 次 编写 ,到 处 运行 。JSP 具有 跨 平台 特性 ,几乎 可 以 在 所 有 平台 上 
的 任意 环境 中 开发 .部署 和 扩展 。JSP 开发 的 Web 应 用 可 以 运行 在 UNIX、Linux 或 
Windows 平台 上 ,Web 服务 器 可 以 选择 WebLogic 或 WebSphere 等 商业 平台 ,也 可 以 使 
用 Apache 和 Tomcat 等 免费 的 服务 器 软件 ,后 台数 据 库 可 根据 实际 情况 选择 Oracle、 
Sybase .DB2 或 Informax 等 。 

与 ASP. NET 比 ,JSP 入 门 相对 困难 ,缺少 ASP. NET 中 那 种 只 需要 简单 的 数据 绑 
定 就 可 以 完成 基本 任务 的 服务 器 控件 ,许多 工作 都 需要 程序 员 自 己 编写 代码 来 实现 。 另 
外 ,由 于 开发 工具 众多 、Web 框架 技术 层出不穷 .JSP 程序 员 不 得 不 经 常 面临 艰难 的 


14 Web 客 户 端 开发 技术 


Web 客户 端的 主要 任务 是 展现 信息 的 内 容 。 为 了 能 够 为 用 户 提供 一 个 友好 的 人 机 界 
面 ,简单 地 依靠 HTML 是 不 够 的 ,必须 依靠 一 些 客户 端 开发 技术 ,例如 CSS、JavaScript 和 
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AJAX 等 。 下 面 简单 介绍 几 种 在 Web 客户 端 开发 中 常用 的 技术 。 
141 CSS 


CSS(Cascading Style Sheets ,级 联 样式 表 ) 是 一 种 描述 性 的 文本 ,可 以 有 效 地 对 页 面 
的 布局 .字体 .颜色 .背景 和 其 他 效果 实现 更 加 精确 的 控制 。 使 用 CSS 允许 样式 信息 (以 
. CSS 为 后 级 存储 成 一 个 独立 的 文件 ) 与 网 页 内 容 (HTML) 相 分 离 ,使 得 网 站 中 所 有 网 页 
的 表现 风格 统一 。 只 要 对 样式 表 中 相应 的 代码 做 一 些 简 单 的 修改 ,就 可 以 改变 同一 页 面 
的 不 同 部 分 ,或 者 网 站 的 所 有 网 页 的 外 观 和 格式 。 

CSS 与 HTML 中 的 DIV 标签 结合 ,成 为 Web 页 面 布局 设计 的 最 主要 技术 。 


142 JaveScript 


JavaScript 是 浏览 器 能 够 识别 和 解释 的 第 一 种 具有 通用 目的 的 动态 的 客户 端 脚本 
语言 。 用 JavaScript 可 以 做 许多 事情 。 通 过 与 CSS 结合 ,可 以 使 网 页 更 具 交 互 性 ,能 够 
站 点 的 用 户 提供 更 好 、 更 令 人 兴奋 的 体验 。 例 如 漂亮 的 数字 钟 有 广告 效果 的 跑马 灯 
等 。JavaScript 还 可 以 用 来 完成 一 部 分 业务 逻辑 ,以 减少 服务 器 的 负担 ,例如 表单 验 
证 等 。 

JavaScript 语法 简单 易学 ,常用 的 功能 代码 在 网 上 随处 可 见 。 很 多 时 候 , 程 序 员 只 需 
要 简单 地 复制 .粘贴 ,就 能 够 实现 所 需 的 功能 。 

另外 ,一 些 JavaScript 库 的 出 现 , 使 得 程序 员 能 避 开 那些 乏味 的 非 交 互 内 容 , 利 用 库 
提供 的 大 量 方法 扩展 Web 页 面 。 利 用 JavaScript 库 ,开发 者 能 够 更 方便 地 处 理 特效 、 动 
夯 、 事 件 、Ajax 及 用 户 交 互 组 件 , 从 而 提高 开发 效率 。 目 前 最 为 流行 的 JavaScript 库 包 括 
JQuery、YUI、Prototype、MooTools 和 Dojo。 其 中 的 JQuery 最 简洁 ,也 最 容易 理解 , 基 
于 JQuery 的 各 种 插件 在 网 络 上 随处 可 见 。 


四 演 


143 XML 


XML(Extensible Markup Language, 可 扩展 置 标语 言 ) 是 W3C 组 织 给 出 的 一 种 可 
扩展 的 元 置 标语 言 ,是 SGML 的 一 个 简化 子 集 。 这 个 子 集 是 专 为 Web 环境 设计 的 。 
XML 不 像 HTML 那样 必须 使 用 已 经 定义 好 的 标签 ,而 是 允许 开发 人 员 根据 它 所 提供 的 
规则 ,制定 各 种 各 样 的 置 标语 言 。 严 格 地 说 ,XML 不 应 简单 地 归 类 到 客户 端 开发 技术 
中 。XML 的 主要 任务 在 于 描述 数据 ,尤其 是 用 来 描述 结构 化 的 数据 。 利 用 XML ,允许 
在 跨 平 台 、 分 布 式 或 是 异 质 性 的 环境 中 以 一 种 中 立 ,标准 的 格式 交换 数据 。 


144 AJAX 


AJAX 是 Asynchronous JavaScript and XML( 异 步 JavaScript 和 XML) 的 缩写 , 它 
不 是 一 种 技术 ,而 是 多 种 功能 强大 的 技术 的 综合 。 它 使 用 XHTML 和 CSS 表达 信息 ;使 
用 DOM(Document Object Model, 文 档 对 象 模型 ) 进 行动 态 显示 和 交互 ;使 用 XML 和 
XSLT 进行 数据 交换 和 处 理 ; 使 用 XML HttpRequest 进行 异步 数据 检索 ;使 用 JavaScript 将 
以 上 技术 融合 在 一 起 。 
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利用 AJAX 技术 ,可 以 改善 表单 验证 方式 ,不 再 需要 打开 新 页 面 , 也 不 再 需要 将 整个 
页 面 数 据 提交 ;不 需 刷新 页 面 就 可 改变 页 面 内 容 , 减 少 用 户 等 待 时 间 ; 使 得 客户 端 能 够 实 
现 按 需 获取 数据 ,每 次 只 从 服务 器 端 获取 需要 的 数据 。 利 用 AJAX 技术 ,可 以 实现 客户 
端 异步 地 与 服务 器 进行 交互 ;在 交互 过 程 中 ,用 户 无 须 等 待 ,可 继续 操作 。 

AJAX 技术 是 Web 2. 0 时 代 最 激动 人 心 的 技术 之 一 ,很 多 JavaScript 库 中 封装 了 
AJAX 操作 ,程序 员 只 需要 一 个 简单 的 方法 调用 ,就 能 够 实现 客户 端 与 服务 器 端 无 刷新 
的 数据 交换 。 


145 DCM 和 DHTML 


DOM(Document Object Model ,文档 对 象 模型 ) 是 W3C 组 织 推荐 的 处 理 可 扩展 置 标 
语言 的 标准 编程 接口 。 根 据 该 标准 ,网 页 中 的 每 一 个 元 素 , 例 如 志 body 二 .二 div 之 和 
一 a 二 都 可 以 直接 以 可 编程 的 方式 访问 。DOM 为 文档 中 的 元 素 增加 了 事件 处 理 能 力 , 使 
得 浏览 器 能 够 对 用 户 的 输入 做 出 反应 。 通 过 执行 脚本 ,可 以 动态 地 在 网 页 中 增加 一 幅 图 
片 ,动态 地 添加 或 删除 表格 中 的 一 行 。 

DOM 客户 端 脚本 和 CSS 三 种 技术 结合 ,就 是 我 们 平时 所 说 的 DHTML(Dynamic 
HTML ,动态 HTML)。 


146 HIML5 


HTML 5 是 近 十 年 来 Web 开发 标准 最 巨大 的 飞跃 。 和 以 前 的 版 本 不 同 ,HTML 5 
并 非 仅仅 用 来 表示 Web 内 容 , 它 的 新 使 命 是 将 Web 带 入 一 个 成 熟 的 应 用 平台 。 在 
HTML 5 平台 上 ,视频 音频、 图像 .动画 以 及 同 电脑 的 交互 都 被 标准 化 。 

HTML 5 强化 了 Web 网 页 的 表现 性 能 。HTML 5 提供 了 很 多 新 的 标签 ,例如 ,允许 
使 用 JavaScript 直接 在 网 页 上 绘制 图 像 的 2D 绘图 标签 二 canvas 二 ,这 意味 着 用 户 可 以 脱 
离 Flash 和 Silverlight, 直接 在 浏览 器 中 显示 图 形 或 动画 ;能 够 完成 在 线 视频 、 音 频 播放 的 
多 媒体 标签 二 video 之 和 二 audio 二 ;完成 页 面 导 航 和 布局 的 标签 二 article 二 一 footer 二 、 
一 header 二 一 nav 二 、 一 aside 二 、 一 section 二 等 。 另 外 ,HTML 提供 了 对 本 地 存储 的 支 
持 , 这 个 功能 将 内 谤 一 个 本 地 的 SQL 数据 库 , 以 加 速 交互 式 搜索 ,缓存 以 及 索引 功能 。 
一 些 现 有 的 修饰 标签 ,例如 过 hl 过、 二 font 二 等 将 被 剔除 ,取而代之 的 是 采用 CSS 实现 响 
应 的 效果 。 

简 而 言 之 ,HTML 5 是 用 于 取代 1999 年 所 制定 的 HTML 4.01 和 XHTML 1. 0 标 
准 的 HTML 标准 版 本 ,尽管 目前 仍 在 开发 中 ,但 主流 的 浏览 器 已 经 开始 支持 HTML 5 
的 部 分 元 素 和 部 分 API。 目 前 ,Internet 上 已 经 有 了 很 多 展示 HTML 5 特性 的 网 站 , 读 
者 不 妨 去 体验 一 下 其 激动 人 心 的 效果 。 


15 用 MEdipse 开 发 Web 应 用 程序 


MyEclipse 是 程序 员 在 开发 基于 Java 的 Web 应 用 时 最 常用 的 IDE 工具 之 一 ,下 面 将 介 
绍 如 何 利用 MyEclipse 开发 和 部 署 应 用 Web 程序 。 这 里 所 用 MyEclipse 版 本 号 为 8. 6。 
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151 创建 WEdipse Web 项 目 


首先 ,启动 MyEclipse, 在 File 菜单 中 选择 New 一 Web Project 命令 ,打开 New Web 
Project 对 话 框 。 在 Project Name 文本 框 中 ,输入 项 目 名 称 "Notes”, 其 他 选项 可 以 使 用 
默认 的 设置 ,如 图 1-4 所 示 。 


人 New Web Project 


Create a Web project 
Create a web project in the workspace or an external locatil 


[Web Project Details 
Project Nane: otes 
Location: VS Use default location 


Directory: Fi\siruis\vorkapace\lores 
Source 1older: Bre 
Yeb root folder: ffebRoot 
Context root URL: /lotes 


[J2EE Specification Level 
© Java EE 5.0 (JE 1.4 ©( J2E 1.3 


TiEaven- 
厂 kad 了 ven support 

Learn aore about MavenklvEclinae 
J6T 
FF aa 


cp to WE3-INF/1ib folder? 


@ 5 coeel 


图 1-4 New Web Project 对 话 框 


单 击 Finish 按钮 后 , MyEclipse 将 创建 Notes 工程 的 目录 结构 ,包括 src 和 WebRoot 
目录 ,并 将 JRE Smstem Library 和 Java EE 5 Libraries 等 JAR 库 加 到 项 目的 Build Path 
中 ,如 图 1-5 所 示 。src 目录 中 通常 存放 用 于 处 理 业务 
逻辑 的 Java 源码 , WebRoot 中 通常 用 于 存放 HTML、 上 
JSP 和 图 片 等 静态 文件 。 在 实际 开发 中 ,程序 员 会 把 Sa Je peten Lian [om TE 46020] 
不 同 的 文件 和 资源 放 到 不 同 的 目录 中 。 为 此 ,可 以 通 ebkoo 


Df NETA-INF 
过 用 鼠标 右 击 WebRoot, 在 弹出 的 快捷 菜单 中 执行 |， 
New 一 Folder 命令 来 创建 所 需 的 子 目录 。 Fr 


国 index. jsp 


WebRoot 下 包括 一 个 WEB-INF 目录 和 一 个 站 
点 配置 文件 web. xml。 通 常 ,在 开发 项 目 时 用 到 的 
JDBC 驱动 Struts 2 架 包 等 JAR 文件 需要 复制 到 
WEB-INF 目录 下 的 lib 子 目 录 中 ,web. xml 中 一 般 包 含 在 项 目 中 用 到 的 过 滤器 、servlet 
和 welcome 文件 等 的 配置 。 


152 创建 文件 


在 Web 应 用 开发 的 过 程 中 ,经 常 需要 创建 HTML JSP 和 CSS 等 文件 。MyEclipse 
为 常用 的 类 型 文件 提供 了 创建 向 导 , 程 序 员 可 以 根据 向 导 的 提示 ,很 方便 地 创建 出 所 需 


图 1-5 Web 目录 结构 
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要 的 文件 。 

下 面 以 创建 一 个 JSP 文件 为 例 来 演示 MyEclipse 新 建文 件 向 导 的 用 法 。 首 先 ,在 包 
资源 管理 器 Package Explorer 中 选中 新 建 的 Notes 项 目 , 单 击 鼠 标 右键 ,在 弹出 的 菜单 
中 选择 New 一 Other 命令 ,再 在 选择 向 导 中 选择 MyEclipse-> Web-~>JSP, 然 后 单 击 Next 
按钮 。 

接 下 来 ,在 弹出 的 JSP 创建 向 导 中 ,将 文件 的 名 字 改 为 MyJsp. jsp, 然 后 选择 使 用 默 
认 的 JSP 模板 ,最 后 单 击 Finish 按钮 完成 创建 工作 ,如 图 1-6 所 示 。 


二 
]5p Wizard © 
Create anew J5P page, J| 
Fe Path: oresiwebRoor Browse... | 
Fletome; yspp 
Template to use: [Defa J5P tenplate 可 
@ [Ere] el 


图 1-6 JSP 创建 向 导 


文件 创建 后 , MyEclipse 会 自动 在 编辑 器 中 打开 它 ,程序 员 可 以 根据 需要 来 对 它 进行 
修改 。 
153 配置 Toncat 应 用 程序 服务 器 


在 MyEclipse 中 能 够 很 方便 地 将 应 用 程序 发 布 到 Web 服务 器 上 。MyElipse 支持 大 
多 数 流行 的 Web 服务 器 ,Tomcat 就 是 其 中 的 一 个 。Tomcat 服务 器 是 一 个 免费 的 开放 
源 代码 的 Web 应 用 服务 器 。Tomcat 是 Apache 软件 基金 会 (Apache Software 
Foundation) 的 Jakarta 项 目 中 的 一 个 核心 项 目 , 由 Apache、Sun 和 其 他 一 些 公司 及 个 人 
共同 开发 而 成 。 读 者 可 以 到 Tomcat 的 官方 网 站 下 载 最 新 的 版 本 ,网 址 为 http:// 
tomcat, apache. org。 由 于 Tomcat 的 安装 比较 简单 ,在 此 不 再 袭 述 。 

下 面 介绍 如 何在 MyEclipse 中 配置 Tomcat 应 用 服务 器 。 执 行 Window 菜单 下 的 
Preferences 命令 ,然后 在 弹出 的 Preferences 对 话 框 中 依次 单 击 MyEclipse 一 Servers 一 
Tomcat 一 Tomcat 7. x, 如 图 1-7 所 示 。 选 中 对 话 框 中 的 Enable 选项 , 接 下 来 利用 
Tomcat home directory 后 面 的 Browse 按钮 选择 Tomcat 7. x 的 安装 路 径 。 有 时 ,需要 为 
Tomcat 配置 Java 虚拟 机 ,通过 单 击 图 1-7 中 左 栏 Tomcat 7.x 下 的 JDK ,切换 到 JDK 配 
置 界面 添加 Java 虚拟 机 ,如 图 1-8 所 示 。 

最 后 , 单 击 Preferences 对 话 框 中 的 OK 按钮 ,确认 上 述 操作 ,完成 Tomcat 服务 器 的 
配置 。 


154 部 署 和 测试 Web 应 用 程序 


在 完成 了 上 面 的 工作 以 后 , 接 下 来 要 部 署 和 测试 创建 的 Web 项 目 。 部 署 一 个 Web 
应 用 程序 的 过 程 , 就 是 在 Web 服务 器 上 发 布 Web 站 点 的 过 程 。 
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图 1-8 为 Tomcat 配置 Java 虚拟 机 图 1-9 部 署 Web 应 用 程序 


单 击 工具 栏 中 的 本 按钮 ,弹出 Project Deployments 部 署 管理 对 话 框 ,如 图 1-9 所 示 。 
Project Deployments 对 话 框 中 包含 三 个 主要 按钮 。 

(1) Add 按钮 : 用 于 创建 一 个 新 的 Web 应 用 程序 部 署 。 单 击 该 按钮 ,在 弹出 的 New 
Deployments 对 话 框 的 Server 下 拉 列 表 框 中 选择 合适 的 Web 服务 程序 。 这 里 选择 
Tomcat 7. x。 在 Web 开发 阶段 ,可 以 选择 将 Web 应 用 程序 部 署 为 Exploded Archive 
(development mode) ,每 一 个 HTML、JSP 文件 都 会 以 独立 的 形式 出 现在 Web 服务 器 
中 ;而 在 发 布 成 品 时 ,可 以 选择 将 Web 服务 程序 部 署 成 Packaged Archive(production 
mode) ,发 布 到 Web 服务 器 的 所 有 文件 将 会 被 打包 到 一 个 WAR 文件 中 。 
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(2) Remove 按钮 : 用 于 从 Web 服务 器 中 删除 一 个 Web 应 用 程序 部 署 。 

(3) Redeploy 按钮 : 当 修改 了 Web 服务 程序 的 代码 时 ,可 以 通过 该 按钮 将 改变 重新 
发 布 到 Web 服务 器 上 。 一 般 情 况 下 , 当 HTML、CSS 或 者 JSP 文件 的 内 容 修改 后 ， 
MyEclipse 会 自动 将 改变 发 布 到 Web 服务 器 上 ;而 当 Java 源 代 码 发 生 修改 后 ,通常 需要 
利用 Redeploy 按钮 手工 进行 重新 部 署 。 

成 功 部 署 后 , 单 击 厦 图 右边 的 下 拉 箭头 ,然后 选择 Tomcat 7. x~>Start 启动 Tomcat 
应 用 服务 器 ,根据 控制 台中 的 信息 查看 Tomcat 是 否 启 动 成 功 。 

启动 成 功 后 ,打开 Web 浏览 器 ,在 地 址 栏 中 输入 http://localhost: 8080/Notes/ 
hello. jsp。 如 果 能 看 到 预期 的 页 面 ,那么 Web 应 用 程序 部 署 就 成 功 了 。 


16 对 Web 开 发 初学 者 的 建议 


Web 应 用 程序 设计 与 传统 的 桌面 程序 设计 是 不 同 的 ,初学 者 首先 应 该 弄 清 B/S 的 工 
作 原 理 , 和 弄 清 服务 器 和 客户 端 之 间 的 信息 交互 方式 。 

学 习 Web 开发 需要 掌握 的 知识 很 多 ,初学 者 不 可 能 一 下 子 全 都 学 习 。 建 议 先 熟 悉 
基本 的 HTML 标签 ,能 够 通过 HTML 标签 将 需要 展示 的 内 容 先 展示 出 来 。 至 于 页 面 显 
示 效 果 , 先 不 必 考 虑 。 

从 国内 目前 的 开发 看 , 走 Java 路 线 的 开发 者 ,需要 学 习 的 知识 包括 JSP、Servlet、 
Struts 2、Spring 和 Hibernate 等 。HTML 中 艇 入 JSP 标签 和 Java 脚本 的 开发 方式 已 经 
淡出 历史 舞台 ,建议 初学 者 在 花费 一 定 的 时 间 弄 清 基本 的 JSP 概念 ,和 弄 清 Servlet 的 工作 
机 制 后 ,将 精力 投入 到 基于 MVC 模式 的 Web 架构 的 学 习 上 来 。 目 前 来 看 ,Struts 2 是 必 
须要 掌握 的 ,尤其 是 它 的 值 传 递 功能 。 至 于 Spring, 在 开发 时 主要 使 用 的 是 它 的 IoC 
(Inversion of Control ,控制 反 转 ) 机 制 。Hibernate 主要 用 于 完成 数据 的 持久 化 ,对 于 初 
学 者 过 于 复杂 。 作 者 更 建议 从 iBatis 入 手 。 

基本 的 CSS 语法 必须 掌握 ,不 必 去 背诵 每 个 样式 属性 的 名 称 , 因 为 利用 CSS 设计 工 
具 能 够 很 容易 地 完成 样式 的 设计 。JavaScript 和 AJAX 比较 枯燥 , Web 前 台 开 发 初学 者 
可 以 在 掌握 JavaScript 基本 语法 和 AJAX 的 原理 的 基础 上 ,直接 利用 JQuery 等 
JavaScript 库 去 完成 这 部 分 工作 。 

即使 是 其 中 的 某 一 门 技术 ,也 是 很 复杂 的 。 作 者 在 以 往 的 教学 过 程 中 ,经 常 发 现 很 
多 同学 捧 着 厚 厚 的 一 本 大 “砖头 ”, 在 很 吃力 、 很 细致 地 * 哺 ”。 这 是 一 种 费时 .自虐 式 的 学 
习 方 法 ,很 多 人 读 到 一 半 就 很 难 再 读 下 去 了 。 即 使 是 硬 着 头皮 读 下 去 ,等 读 到 最 后 一 页 ， 
估计 也 很 难 想起 前 面 章节 讲授 的 内 容 了 。 作 者 建议 初学 者 在 拿 到 一 本 技术 书后 ,能 够 在 
一 两 周 内 从 头 至 尾 看 一 遍 , 从 全 局 上 了 解 这 门 技术 都 包括 哪些 方面 ,每 一 个 方面 是 解决 
什么 问题 的 。 然 后 , 找 一 个 小 的 项 目 , 例 如 一 个 留言 板 或 者 博客 程序 ,自己 慢 慢 摸索 着 去 
做 ,在 做 的 过 程 中 遇 到 问题 了 ,再 带 着 问题 去 看 书 中 相应 的 内 容 。 

“和 欲 善 其 事 , 必 先 利 其 器 ” ,掌握 一 个 好 的 开发 工具 是 很 重要 的 。MyEclipse 是 进行 
Java Web 开发 不 可 缺少 的 ,能 够 减少 开发 者 的 很 多 工作 量 。Dreamweaver 是 进行 页 面 布 
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局 和 CSS 设计 的 最 佳 工具 ,尤其 是 Dreamweaver CS 5. 5 更 是 提供 了 对 HTML 5 和 
JQuery 的 支持 。Mozilla Firefox 是 一 个 优秀 的 Web 浏览 器 ,完全 遵循 W3C 标准 ,在 安 
装 上 Firebug 插件 之 后 ,开发 者 能 够 轻易 地 对 CSS HTML .DOM 以 及 JavaScript 代码 进 
行 调试 。 

简 而 言 之 ,要 想 成 为 一 名 Web 程序 开发 高 手 , 必 须要 耐 得 住 寂寞 , 扎 扎实 实 ,一 步 步 
地 充实 自己 。 
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21 JSP 中 的 HIML 代 码 


211 HIM 常用 标签 


HTML(HyperText Markup Language, 超 文本 置 标语 言 ) 是 一 种 用 于 创建 网 页 的 置 
标语 言 。 利 用 HTML 提供 的 标签 可 以 定义 要 显示 的 网 页 中 的 各 个 部 分 ,可 以 将 图 片 \ 声 
音 、 动 画 和 视频 等 内 容 镰 嵌 到 文本 文件 中 。Web 浏览 程序 通过 分 析 网 页 文件 中 的 
HTML 标签 可 以 知道 如 何 显示 网 页 信息 ,如 何 链接 各 种 信息 。 

超 链 接 是 网 页 重要 的 元 素 之 一 。 各 个 网 页 链接 在 一 起 后 ,才能 真正 构成 一 个 网 站 。 
在 上 网 冲浪 时 , 正 是 利用 超 链接 ,用 户 可 以 从 一 个 网 页 很 方便 地 跳 转 到 另 一 个 网 页 或 是 
另 一 个 网 站 。 

HTML 标签 是 为 了 达到 某 种 效果 ,在 内 容 中 加 入 的 特定 的 标识 。 标 签 都 括 在 一 对 
尖 括 号 "二 ”和 “二 ”内 ,中 间 加 入 受 标记 控制 的 内 容 。 标 签 分 成 单一 标签 和 成 对 标签 两 
种 。 单 一 标签 如 过 hr/ 二 和 所 br/ 二 等 ,成 对 标签 如 二 html 之 和 过/html 二 二 form 之 和 
二 /form> 等 。 通 常 ,HTML 标签 应 该 使 用 小 写 形式 。 

下 面 介 绍 HTML 中 常见 的 一 些 标签 。 

1 HIM 文档 结构 

利用 HTML 创建 的 文档 称 为 网 页 或 是 Web 文档 。 通 常 ,HTML 文件 的 结构 包括 
文档 头 部 (Head) 和 文档 主体 (Body) 两 大 部 分 。 其 中 ,文档 头 部 用 于 描述 浏览 器 所 需 的 
信息 ,例如 网 页 的 标题 (Title) 和 各 种 meta 标签 等 ;文档 主体 包含 所 要 说 明 的 具体 内 容 。 
代码 2-1 给 出 了 一 个 简单 的 HTML 文档 。 


代码 2-1 一 个 简单 的 HTML 文档 实例 


<html> 
<head> 
<meta http- eqai "Content- Type" content= "text/html;dharset=utf- 8" /> 
<title> 留 言 板 < /title> 
< /head> 
<body> 
<hl> 欢 迎 使 用 留言 板 程序 < /bl> 
< /body> 
< /html> 
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代码 执行 结果 如 图 2-1 所 示 。 
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欢迎 使 用 留言 板 程序 


图 2-1 简单 的 HTML 文档 


meta 标签 是 可 选 的 ,有 时 利用 meta 标签 说 明 网 页 所 使 用 的 字符 集 。 例 如 ,下 面 的 代 
码 将 网 页 字符 集 指 定 为 gb2312( 简 体 中 文 ) : 


<meta http- equiv= "Content- TYPe" content= "text/html; charset= go2312" /> 


除 gb2312 之 外 ,比较 常见 的 字符 集 还 有 ISO-8859-1 .utf8 和 GBK 等 。 

如 果 和 希望 每 隔 5 秒 刷 新 一 次 网 页 ,可 以 在 文档 头 部 加 入 以 下 代码 : 

<meta http equiv= "refresh" oontent= "5"/> 

其 中 ,http-equiv 和 content 是 meta 标记 的 属性 。 大 多 数 HTML 标记 都 有 各 自 的 属 
性 ,在 使 用 标签 时 可 以 通过 设置 这 些 属性 值 来 获得 特定 的 显示 效果 。 通 常 ,属性 值 应 该 使 
用 双 引 号 或 者 单 引 号 括 起 来 。 需 要 说 明 的 是 ,现在 的 设计 理念 更 推崇 利用 CSS(Cascading 
Style Sheet ,级 联 样式 表 ) 来 设置 网 页 的 外 观 。 

2 段落 和 文字 标签 

(1) 段落 标签 二 p 之 和 二/p 之 : 标签 二 p 二 表示 一 个 段落 的 开始 ,二 /p 二 表示 段落 的 
结束 。 使 用 段落 标签 不 但 可 以 使 文字 换行 ,而 且 会 在 不 同 段落 文字 间 添 加 一 行 空白 加 以 
间隔 。 其 语法 如 下 : 

< 户 文 字 < /E> 

(2) 强制 换行 标签 过 br 二 : 在 网 页 中 ,如 果 和 希望 换行 显示 后 续 内 容 , 一 定 要 使 用 
二 br> ,语法 如 下 : 

文字 <br/> 

(3) 块 标签 一 div 之 : 通常 用 于 实现 页 面 的 布局 。 

(4) 标题 标签 hn: 类 似 于 Word 中 的 一 级 标题 和 二 级 标题 等 。 利 用 HTML 中 的 标 
题 标 签 ,可 以 定义 页 面 上 的 一 到 六 级 标题 。 语 法 如 下 : 

<hm 标 题 文字 < /hn> 

其 中 ,n 取 值 为 1~6。n 二 1 时 ,文字 最 大 。 

(5) 过 pre 二 标签 : 将 在 其 他 文本 编辑 工具 中 编辑 好 的 文本 粘贴 到 网 页 中 时 ,如 果 和 希 
望 保留 文本 的 段落 格式 ,可 以 使 用 一 pre 之 标签 。 毛 pre 之 标签 的 一 个 常见 的 应 用 实例 就 
是 在 网 页 中 发 布 程序 的 源码 。 语 法 如 下 : 
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<pre> 预 定义 格式 的 段落 < /pre> 


(6) 注释 标签 : 利用 注释 ,可 以 对 Web 文档 的 内 容 添加 描述 信息 。 添 加 了 HTML 
注释 的 内 容 会 和 其 他 内 容 一 样 被 传送 到 客户 端 ,但 是 浏览 器 在 分 析 网 页 时 会 被 忽略 。 
(7) 水 平 线 标签 二 hr/ 二 : 在 网 页 中 插入 一 条 水 平 线 。 语 法 如 下 : 


<hr aligm= left|osnter|right size- 线 粗 widtd= 线 宽 color= 颜 色 /> 
(8) 文字 标签 二 font 之 : 用 于 定义 文字 的 显示 外 观 , 语 法 如 下 : 
< fcnt size= 数 字 face= 字 体 名 color= 颜 色 > 文字 < /font> 
代码 2-2 为 段落 和 文字 标签 实例 。 
代码 2-2 段落 和 文字 标签 实例 


<htm> 
<head> 
<meta http- eqaiv- "Content- Type" oontent- "text/html; dharset=utf- 8" /> 
<title> 段 落 标签 < /title> 
< head> 
<body> 
<h2 align= "center"> < font color= 啡 E0000" faoe= 叶 体 吃 第 2 章 JSP 基 本 语法 < /fant></ 
he> 
<hr/> 
<h3>2.1 gSP 中 的 EM 代码 < /hb3> 
<h4> 2.1.1 HML 常 用 标签 < /h4> 
<FP sanbsp;&nbep;HIML HyperText Marlap Ianguage, 超 文本 置 标语 言 ) ,是 一 种 用 于 创建 网 页 的 
置 标语 言 。< /p> 
<Er gnbsp;&nbsp; 超 链接 是 网 页 重要 的 元 素 之 一 。 各 个 网 页 链接 在 一 起 后 ,才能 真正 构成 
一 个 网 站 。 在 上 网 冲浪 时 , 正 是 利用 超 链 接 ,我 们 可 以 从 一 个 网 页 很 方便 地 跳 转 到 另 一 
个 网 页 或 是 另 一 个 网 站 。< /p> 
<div>1. 强 制 换行 标签 alt;brsgt;: 在 网 页 中 如 果 和 希望 换行 显示 后 续 内 容 ,一 定 要 使 用 st; 
brggt;< /div> 
<div> 2. 注 释 标签 : 利用 注释 可 以 对 web 文档 的 内 容 添加 描述 信息 。 添 加 了 HmML 注 释 的 内 
容 会 和 其 他 内 容 一 样 被 传送 到 客户 端 ,但 是 浏览 器 在 分 析 网 页 时 会 被 忽略 。< /div> 
< /body> 
< /html> 


代码 执行 结果 如 图 2-2 所 示 。 


3 列表 标记 

HTML 提供 的 列表 中 比较 常用 的 是 有 序列 表 和 无 序列 表 。 

(1) 有 序列 表 

有 序列 表 标 记 为 二 ol 二 ,每 一 列 使 用 二 li 二 标签 定义 ,每 列 使 用 数字 或 字母 开头 。 格 
式 如 下 : 


<ol type= "AlalIli"> 
<1Ji> 项 目 lc Ai> 
<1i> 项 目 < Ai> 
<1i> 项 目 zx Ai> 
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</ol> 
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2. 1 JSP 中 的 HTML 代 码 
2.1.1 HEL 常 用 标签 


HTL (EyperText Jarkup Langusge， 拒 文 证 仁 标 语言 ) ， 是 一 种 月 于 创建 网 页 的 二 标语 言 。 


超 链 接 是 网 页 重要 的 元 素 之 一 。 各 个 网 页 链接 在 一 起 后 ， 才 能 真正 构成 一 个 网 站 。 在 上 网 冲浪 时 ， 正 是 
利用 超 缮 接 ， 我 们 可以 从 一 个 网 页 各 方便 地 号 苇 到 另 一 个 问 太 起 是 另 一 个 网 站 。 


二 各 个 村 条 人 i 
释 标 签 ， 利 用 注释 可 以 对 eb 文档 的 内 容 条 加 : 信息 有 样 被 
站 但 是 浏览 器 在 分 析 网 页 时 会 被 忽略 - 


2-2 段落 和 文字 标签 实例 的 运行 结果 


其 中 ,type 属性 规定 列表 的 项 目 符号 的 类 型 ,默认 值 为 1, 表 示 列 表 符 号 为 阿拉 伯 数 
字 。type 属性 还 可 以 取 值 为 A\a\I\i, 分 别 表 示 列 表 符 号 为 大 写 英 文字 母 . 小 写 英文 字 
母 .大 写 罗马 数字 和 小 写 罗马 数字 。 
(2) 无 序列 表 
无 序列 表 标 记 为 二 ul 二 ,格式 如 下 : 
<ul type= "disc|circle| square"> 
<1i> 项 目 1< Ai> 
<li> 项 目 2< /li> 
<li> 项 目 zx Ai> 
</al> 
其 中 ,type 属性 规定 列表 的 项 目 符号 的 类 型 ,默认 值 为 disc。 
除了 这 两 个 常用 的 列表 标签 外 , HTML 还 提供 了 自 定 义 列 表 二 dl 二 和 选单 列表 
所 menu>, 请 读者 自行 查阅 相关 文献 。 


4 锚 标签 <s 

去 a> 标 签 可 定义 锚 。 锚 (anchor) 有 两 种 用 法 。 

(1) 通过 使 用 href 属性 ,创建 指向 另外 一 个 文档 的 链接 (或 超 链接 ) 。 

(2) 通过 使 用 name 或 id 属性 ,创建 一 个 文档 内 部 的 书签 (也 就 是 说 ,可 以 创建 指向 
文档 片段 的 链接 ) 。 

二 a 二 元 素 最 重要 的 属性 是 href 属性 , 它 指定 链接 的 目标 。 格 式 如 下 : 


<ahref- url 显示 的 文字 < /a> 


5 表格 

表格 通常 用 于 文本 的 结构 化 显示 ,由 二 table 之 标签 来 定义 。 每 个 表格 包括 若干 行 
(由 过 tr 二 标签 定义 ) ,每 行 包括 若干 单元 格 ( 由 过 td 之 标签 定义 ) 。 数 据 单元 格 可 以 包含 
文本 图片. 列表、 段落、 表单 水平线 和 表格 等 。 表 格 的 基本 结构 如 下 : 
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< table border= "1"> 
<tr> 
<td> 单 元 格 内 容 < /td> 


</tr> 


</table> 


table 常用 的 属性 包括 border、width .height ,align、cellspacing 和 cellpadding 等 ,这 
些 属 性 都 是 可 选 的 。 
代码 2-3 给 出 了 一 个 简单 的 表格 示例 。 


代码 2-3 表格 示例 


<html> 
<head> 
<meta http- equiv= "Content- Type" content= "text/html; charset= utf- 8" /> 
< /head> 
<body> 
< table width= "465" border= "1"> 
<tr> 
< th width= "54"> gnbsp;< /th> 
<thwidth= "134"> 属 性 < /th> 
<thwidth= "255"> 说 明 < /th> 
</tr> 
<tr> 
< td rowspar= "2"> table< /td 
< td> cellpaddingc /td> 
<t 中 规定 单元 边沿 与 其 内 容 之 间 的 空白 < /td> 
</tr> 
<tr> 
< tc cellspace< /td> 
<t 中 规定 单元 格 之 间 的 空白 < /to> 
</tr> 
<tr> 
<td rowspanr= "2"> tck /td 
< tc colspanc /td 
<t 中 规定 单元 格 可 横 跨 的 列 数 < /td> 
</tr> 
<tr> 
< to> rowspanc /td> 
<t 中 规定 单元 格 可 横 跨 的 行 数 < /td> 
</tr> 
< /table> 
< /body> 
</htm> 


在 代码 2-3 中 ,表格 的 首 行 中 包含 了 三 个 二 th 二 标签 。 二 th 二 通常 用 于 定义 表格 内 
的 表 头 单元 格 , 其 内 部 的 文本 通常 会 呈现 为 居中 的 粗 体 文本 。 一 td 元素 内 的 文本 通常 
是 左 对 齐 的 普通 文本 。 
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图 2-3 给 出 了 代码 2-3 在 浏览 器 中 呈现 的 效果 。 


212 HIML_ 的 表单 Dhl x 
全 言 CQ @@ file:///D:/ 再 作 /Web 应 用 程序 开发 技术 /code 窜 外 

HTML 表单 主要 用 于 采集 和 提交 用 户 [一 启 攻 开本 
输入 的 信息 。 通 过 HTML 表单 的 各 种 控 | we ES 让 让 和 全 
件 ,用 户 可 以 输入 文字 信息 ,或 者 从 选项 中 Ee Ee 
选择 ,以 及 执行 提交 的 操作 。 

1 表单 标签 图 2-3 表格 运行 效果 

表单 格式 如 下 : 


< fom actionr "url" method= "post | get"> 
< imput typer "控件 类 型 " name= 味 识 符 " /> 


< /fomy> 


其 中 ,各 参数 的 含义 如 下 。 

(1) action 属性 : 用 于 处 理 表单 请 求 的 文件 ,可 以 是 一 个 JSP 文件 、Servlet 类 或 
Struts 2 的 action 类 等 。 

(2) method 属性 : 表示 了 发 送 表 单 信息 的 方式 。method 有 两 个 值 : get 和 post。 默 
认 值 get 的 方式 是 将 表单 控件 的 name/value 信息 经 过 编码 之 后 ,通过 URL 发 送 ,在 
action 指定 的 页 面 返回 给 用 户 时 ,可 以 从 地 址 栏 里 看 到 name/value。post 方式 则 将 表单 
的 内 容 通 过 http 发 送 ,在 地 址 栏 看 不 到 表单 的 提交 信息 。 从 安全 性 的 角度 考虑 ,建议 采 
用 post 方式 。 

表单 中 信息 的 输入 主要 依靠 input 标签 来 完成 。 其 中 ,type 属性 定义 了 输入 控件 的 
类 型 ,name 属性 和 input 的 value 值 构成 的 name/value 对 在 表单 提交 后 交 由 action 所 指 
定 的 文件 进行 处 理 。 

2 文字 和 密码 的 输入 

input 标签 的 type 属性 为 text 时 ,输入 文本 以 明文 方式 显示 。input 标签 的 type 属 
性 为 password 时 ,输入 文本 回 显 为 ”x* ”。 


3 复 选 框 和 单 选 框 
复 选 框 格式 如 下 : 


< input typer "checkbox" name= " 味 识 符 " value= " 值 " checked/> 
单 选 框 格式 如 下 : 

< input typer "radio" name= " 味 识 符 " value= " 值 " checked/> 
checked 表示 默认 选中 该 选项 。 


4 提交 和 重 置 
提交 按钮 格式 如 下 : 
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< input type= "submit" value= "按钮 名 字 "/> 

重 置 按钮 格式 如 下 : 

< input type= "reset" value= "按钮 名 字 "/> 

当 用 户 单 击 submit 按钮 时 ,表单 的 内 容 会 被 传送 到 表单 的 action 所 指示 的 文件 ; 当 
用 户 单 击 reset 按钮 时 ,所 有 表单 中 的 控件 将 恢复 成 默认 值 。 

5 列表 框 和 下 拉 框 

列表 框 和 下 拉 框 格式 如 下 : 


< select size=n name= 哑 识 符 " mltiple> 
<cption value= " 值 " select> 选 择 项 < /option> 


< /select> 


其 中 ,各 参数 含义 如 下 。 

(1) size: 取 值 为 正 整 数 。 当 size 王 1 时 ,控件 外 观 呈现 为 下 拉 框 ; 当 size 之 1 时 ,控件 
外 观 为 列表 框 ,size 值 表示 列表 框 中 一 次 可 见 的 列表 项 数目 ,如 果 列表 项 总 数 二 n, 浏 览 器 
将 自动 为 列表 框 添加 滚动 条 。 

(2) multiple 表示 支持 多 项 选择 。 

(3) option 中 的 select 表示 默认 选中 该 项 。 

6 多 行文 本 框 tetarea 

多 行文 本 框 textarea 格式 如 下 : 

< textarea name= 味 识 符 " rows= 咱 数 " cols=' 哆 数 吃 

< /textarea> 

当 多 行文 本 框 中 的 行 或 列 超过 rows 或 cols 指定 的 值 时 ,浏览 器 将 自动 为 其 添加 横 
向 滚动 条 或 纵向 滚动 条 。 

代码 2-4 所 示 为 表单 运用 实例 。 

代码 2-4 ”表单 运用 实例 (reg.jsp) 


<html> 
<head> 
<title> 留 言 板 注册 < /title> 
< meta http- equiv= Content- Type content= "text/html; charset= gok"> 
< /head> 
<body> 
< form name= "reggorm"action= "doReg.jsp" method= "post"> 
< 了 共用 grbsp; 户 snbsp; 名 : snbsp; 
<input typer "text" maxlengthr "20" size= "40" name= "usememe"/> 
< 人 从 
< 户 密 grbsp;gnbsp; snbsp;&nbsp; 码 : snbsp; 
<input type= "password" mexlengthe "20" size= "40" name= "password"/> 
</p> 
< 户 重 复 密码 : gnbsp; 
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< irput type= "Password" mesdengthe "20" size "40" reme= "passworde"/> 
< 从 
< 共性 gnbsp;snbsp; snbsp;snbsp; 别 :gnbsp; 
女 < input type= "radio" name= "gender" value= "1"/> 
男 < input type= "radio" name= "gender" value= "2" checked /> 
</p 
< 了 学 srbsp; grbsp;srnbsp; grbsp; 历 :sribsp; 
< select name= "educaticn" size= 1> 
<option value= "> 中 专 < /option> 
<caption value= "2"> 大 专 < /option> 
< option value= "3" selected> 本 科 < /cption> 
< option value= "4"> 硕 士 研究 生 < /caption> 
< option value= "5"> 博 士 研究 生 < /cption> 
< option value= "6"> 其 他 < /option> 
</select> 
< 人 > 
< 了 喜好 的 运动 :anbsp; 
<inmput type= "chedibae"' name= "favorite" value= "1" deced/> 篮 球 
< input type= "checkbox" name= "favorite" value= "2" 人 > 足球 
< input type= "checkbox" name= "favorite" value= "3" /> 扑 山 
< input type= "checkbox" name= "favorite" value= "4" /> 游泳 
< imput type= "checkbox" name= "favorite" value= "5" /> 以 上 全 部 
</p 
< 户 自 我 介绍 : 
< textarea name= "intro" rows= "10" cols= "40"> < /textarea> < /p> 
< input type= "submit" value= "注册 "> 
<input type= "reset" value= " 重 置 "/> 
< /fom> 
< /body> 
</htm> 


代码 执行 结果 如 图 2-4 所 示 。 
国电 本 习 汪 册 
€ PC O127.0.0.1 
用 户 名 : 
密码 : 


另 © 
历 : [ 梧 寺 本人 国 


喜好 的 运动 : 回 篮球 回 足球 口 由 山 回 游泳 口 以 上 全 部 
息 是 一 只 小 泊 悉 ， 我 喜光 过 作 季 1 


图 2-4 表单 运用 实例 运行 结果 
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22 JSP 简 介 


JSP 是 由 Sun Microsystems 公司 推出 的 一 种 动态 网 页 技术 标准 。 利 用 JSP 编写 的 页 面 
文件 的 表示 层 (页 面 的 布局 .外观 等 ) 仍 然 采 用 HTML 标签 完成 ,业务 逻辑 则 是 通过 在 
HTML 文件 中 插入 Java 代码 程序 和 JSP 标签 来 实现 。JSP 将 业务 逻辑 与 网 页 设计 和 显示 
分 离 , 支 持 可 重用 的 基于 组 件 的 设计 ,使 得 基于 Web 的 应 用 程序 的 开发 变 得 比较 容易 。 

当 客 户 程序 向 Web 服务 器 请 求 JSP 网 页 时 , Web 服务 器 首先 执行 JSP 程序 中 的 程 
序 段 ,然后 将 执行 结果 连同 JSP 文件 中 的 HTML 代码 一 起 返回 给 客户 。 

JSP 具有 如 下 优点 。 

(1) 跨 平台 支持 。JSP 文件 由 HTML 标签 和 Java 代码 组 成 ,能 够 广泛 地 运行 在 各 
种 平台 下 。 

(2) 编译 后 执行 。 第 一 次 访问 JSP 文件 时 , Web 服务 器 通过 解释 该 JSP 页 面 , 生 成 
一 个 同名 的 Java 文件 ,并 将 该 Java 文件 编译 成 二 进 制 码 (. class 文件 ) ,以 后 再 访问 时 ,就 
直接 调用 二 进 制 码 文件 ,大 大 提高 执行 的 效率 。 

(3) 方便 实现 业务 逻辑 与 页 面 表示 层 相 分 离 。 利 用 JSP 开发 Web 程序 时 ,通常 利用 
HTML 或 XML 等 设计 页 面 的 布局 ,用 Java 来 生成 页 面 中 的 动态 显示 内 容 。 通 常情 况 
下 ,Java 代码 被 封装 在 JavaBean 中 ,在 使 用 Web 框架 的 开发 中 还 可 能 被 封装 在 Action 
或 Servlet 中 ,使 开发 人 员 的 分 工 比较 明确 ,使 得 Web 程序 维护 起 来 更 加 方便 ,页 面 布 局 
和 业务 逻辑 可 以 单独 修改 而 不 会 影响 到 对 方 。 

4 支持 大 型 的 复杂 的 企业 级 应 用 开发 

JSP 完 全 有 能 力 支 持 逻 辑 关系 高 度 复 杂 的 Web 应 用 ,通过 与 Struts 2、 Spring、 
Hibernate 和 Sitemesh 等 框架 技术 结合 ,能够 很 好 地 满足 大 型 的 企业 级 应 用 的 开发 。 


23 JSP 脚 本 及 注释 


在 传统 的 HTML 文件 中 加 入 Java 程序 片段 和 JSP 标签 就 构成 了 一 个 JSP 页 面 文 
件 。 一 个 JSP 页 面 可 由 以 下 5 种 元 素 组 合 而 成 。 

(1) HTML 标签 ; 

(2) JSP 标签 ,包括 指令 标签 和 动作 标签 等 ; 

(3) 变量 和 方法 的 声明 ; 

(4) JSP 的 可 执行 脚本 ; 

(5) JSP 表达 式 。 


231 JSP 的 声明 语句 
在 JSP 页 面 中 可 以 定义 变量 和 方法 ,格式 如 下 : 
<s! 声明 变量 或 方法 s> 
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在 JSP 页 面 中 ,通过 声明 标识 声明 的 变量 和 方法 ,在 整个 页 面 内 都 有 效 , 它 们 将 成 为 
该 JSP 页 面 被 转换 为 Java 类 后 所 得 到 同名 类 中 的 属性 和 方法 ,并 且 会 被 多 个 线程 即 多 个 
用 户 共享 。 也 就 是 说 ,其 中 的 任何 一 个 线程 对 声明 的 变量 或 方法 的 修改 都 会 改变 它们 原 
来 的 状态 。 它 们 的 生命 周期 从 创建 到 服务 器 关闭 后 结束 。 

232 JSP 的 可 执行 脚本 

在 JSP 文件 中 可 以 通过 插入 可 执行 脚本 (Scriptlet) 来 完成 指定 的 业务 功能 。 所 谓 可 
执行 脚本 ,就 是 嵌 在 “二 %...% 二 ”标签 中 的 Java 代码 片段 。 在 脚本 中 可 以 定义 变量 、 定 
义 方法 、 调 用 方法 和 进行 各 种 表达 式 运 算 。 由 于 可 执行 脚本 本 身 就 是 Java 代码 ,因此 每 
行 请 句 后 面 应 该 添加 一 个 分 号 。 舱 入 页 面 的 Java 代码 在 Web 服务 器 响应 请 求 时 会 被 运 
行 。JSP 的 可 执行 脚本 的 书写 格式 如 下 

<suava 程 序 片 段 $> 

需要 注意 的 是 ,在 脚本 中 定义 的 变量 和 方法 仅 在 当前 会 话 的 当前 页 面 内 有 效 , 不 会 
与 其 他 用 户 共享 。 

233 JSP 的 表达 式 

JSP 表达 式 用 于 向 页 面 输出 信息 ,格式 如 下 : 

< 和 = 表达 式 $> 

注意 : 

(1) 表达 式 为 任意 合法 的 Java 语言 规范 中 的 表达 式 。 

(2) 表达 式 末尾 不 能 有 分 号 (“;”) 。 

(3) JSP 的 表达 式 与 在 JSP 页 面 中 嵌入 到 脚本 段 中 的 out. print() 方 法 实现 的 功能 相 
同 。 如 果 表 达 式 输出 的 是 一 个 对 象 , 则 该 对 象 的 toString() 方 法 被 调用 。 

JSP 表达 式 主 要 应 用 在 以 下 几 个 方面 。 

(1) 向 页 面 输出 内 容 , 例 如 : 


< S$String UserName= "zhangsan"; $> 
用 户 名 : <%=userName%> 


(2) 生成 动态 的 链接 地 址 ,例如 : 


< S$String path= "detail .jsp"; $> 
<a href- "< $=paths> 心 详细 内 容 < /a> 


(3) 动态 指定 Form 表单 处 理 页 面 ,例如 : 


<sString actionr "logon.jsp"; s> 
< fom action= "< $=action$> "> 


< /fomr> 
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234 JSP 的 注释 语句 


注释 语句 可 以 帮助 程序 员 识别 和 理解 程序 代码 。 在 JSP 文件 中 可 以 使 用 的 注释 语 
句 分 为 三 种 : HTML 注释 JSP 隐藏 注释 和 脚本 注释 。 


1 HIM 注释 
由 于 JSP 文 件 是 由 HTML 标签 和 榜 入 的 Java 程序 片段 构成 的 ,因此 HTML 注释 
同样 适用 于 JSP 文件 。 请 法 格式 如 下 : 


< 上- cument[<s- 表 达 式 s> |<samvR 执 行 脚本 s> ]--> 


当 包 含 HTML 注释 的 JSP 文件 被 请 求 时 ,JSP 引擎 能 够 识别 并 执行 包含 在 HTML 
注释 中 的 JSP 的 表达 式 和 可 执行 脚本 。 
需要 注意 的 是 ,HTML 注释 会 被 发 送 到 客户 端 。 


2 JSP 隐 藏 注释 
JSP 隐藏 注释 的 语法 格式 如 下 : 


<$-- 注 释 内 容 --$> 


与 HTML 注释 不 同 的 是 ,包含 在 JSP 隐藏 注释 中 的 JSP 表达 式 和 Java 脚本 不 会 执 
行 。 另 外 ,JSP 隐藏 注释 中 的 内 容 不 会 发 送 到 客户 端 ,因此 这 种 方式 不 但 可 以 减少 网 络 流 
量 , 安 全 性 也 更 高 。 

3 脚本 注释 

由 于 脚本 程序 中 所 包含 的 是 一 段 Java 代码 ,所 以 脚本 程序 中 的 注释 方法 和 Java 中 
的 注释 是 相同 的 ,包括 单行 注释 、 多 行 注释 和 提示 文档 注释 三 种 。 读 者 请 自行 参阅 Java 
相关 教材 ,在 此 不 再 袭 述 。 

下 面 通过 代码 2-5 演示 JSP 的 脚本 及 注释 实例 。 


代码 2-5 JSP 的 脚本 及 注释 实例 


< $@ page language= "java" import= "java.util. * " PagesEnooding= "UTF- 8"%> 
<%! 
/* getWeekOfpate 方 法 用 于 计算 今天 是 星期 几 x* / 
String getWeekOfDate () { 
String[] weekDays= {" 星 期 日 " "星期 一 ", "星期 二 ", "星期 三 ", "星期 四 "," 星 期 五 ", "星期 
六 
Calendar cal= Calendar.getInstance (); 
int w= cal.get (Calendar.DRY OF WEEK — 1; 
if (we 0) 
w0; 
Teturn weekDays[w]; 


<html> 
<head> 
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<title> JSP 基 本 语法 < /title> 
< /head> 
< !--HML 注 释 , 客 户 端 可 以 查看 到 一 > 
<s--JSP 注 释 ,客户 端 不 能 查看 到 --%> 
<body> 
< Sif (Calendar.getInstance() .get (Calendar.AM FM)==Calendar.AM) {%> 
上 午 好 ! 
< 当 } else {%> 
下 午 好 ! 
<%]%> 
今天 是 < 和 -= getWeekofDate() $> 
< /body> 
</htm> 


代码 执行 结果 及 客户 端的 源 代码 如 图 2-5 所 示 。 


re 
上 午 好 ! 今天 是 星期 五 "J5F 基 本 语法 dtitle>》 


ad 
HTI 注 绎 , 圭 户 端 可 以 查看 到 一 


Coody> 
上 午 好 1 
12 
今天 星 时 期 五 
| /body) 


htaly 


图 2-5 代码 2-5 执行 结果 及 客户 端的 源 代码 


24 JSP 的 操作 指令 


JSP 指令 元 素 主 要 有 三 种 : page 指令 .include 指令 及 taglib 指令 。 每 个 JSP 指令 都 
以 二 %@ 标 签 开始 ,以 % 二 标签 结束 。 三 种 指令 的 通用 格式 如 下 : 


<%@ 指 令 名 称 属性 二 "属性 值 "属性 二 "属性 值 " …3> 


241 pege 指 令 
page 指令 用 于 定义 JSP 文件 中 有 效 的 属性 。 格 式 如 下 : 


< $8 page 
[language= "java"] 
[contentType= "mimeType; harset— CHARSET"] 
[limport= "{package.class|pageage. * },.."] 
[extends— "package.class"] 
[session= "true| false"] 
[buffer= "none| 8kb| size Kb] 
[autcFlush= "true| false"] 
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[isthreadsafe— "true| false"] 
[info= "text"] 

[errorpage— "relativeURL"] 
[isErrorPage= "true| false"] 
[isELIgnored= "true| false"] 
IEagsEncoding- "CHARSET"] 

s> 

page 指令 可 以 放 在 JSP 页 面 中 的 任意 位 置 。page 指令 包含 多 种 属性 ,通过 设置 这 
些 属性 可 以 影响 到 当前 的 JSP 页面。 除 import 属性 外 ,page 指令 中 的 其 他 属性 只 能 在 
指令 中 出 现 一 次 。 

page 指令 各 属性 的 功能 如 下 。 

(1) language: 设置 当前 页 面 中 编写 JSP 脚本 使 用 的 语言 ,默认 值 为 Java。 

(2) import: 设置 当前 JSP 文件 中 需要 导入 的 类 包 。 在 page 指令 中 可 多 次 使 用 该 属 
性 来 导入 多 个 包 。 默 认 情 况 下 ,JSP 自动 导入 包 java. lang. * 、javax. servlet. x* 、javax。 
servlet. jsp. * 和 javax. servlet. http. * 。 

(3) contentType: 设置 响应 结果 的 MIME 类 型 。 默 认 的 MIME 类 型 是 text/html， 
默认 的 字符 编码 为 ISO-8859-1。 当 多 次 使 用 page 指令 时 ,该 属性 只 在 第 一 次 使 用 时 
有 效 。 

(4) session: 设置 当前 页 面 是 否 支持 session。 默 认 值 为 true, 表 示 支 持 session。 

(5) buffer: 设置 out 对 象 使 用 的 缓冲 区 的 大 小 。 如 设置 为 none, 说 明 不 使 用 缓存 ， 
而 直接 通过 out 对 象 进行 输出 ;如 果 将 该 属性 指定 为 数值 , 则 输出 缓冲 区 的 大 小 不 应 小 于 
该 值 。buffer 的 默认 值 为 SKB。 

(6) autoFlush: 设置 输出 流 的 缓冲 区 是 否 自 动 清除 。 默 认 值 为 true, 说 明 当 缓冲 区 
已 满 时 ,自动 将 其 中 的 内 容 输出 到 客户 端 。 如 果 设 置 为 false, 则 当 缓 冲 区 中 的 内 容 超出 
其 设置 的 大 小 时 ,会 产生 JSP Buffer overflow 溢出 异常 。 

(7) isErrorPage: 用 于 说 明 当 前 JSP 页 面 是 否 作为 错误 处 理 页 面 。 该 属性 默认 值 为 
false。 如 果 设 置 为 true,JSP 容器 会 在 当前 页 面 中 生成 一 个 exception 对 象 ,用 于 捕捉 其 
他 页 面 传 回 的 错误 。 

(8) errorPage: 指定 一 个 当前 页 面 出 现 异常 时 所 要 调用 的 页 面 , 即 iSErrorPage 属 
性 为 true 的 JSP 页 面 。 

(9) isELIgnored: 可 以 使 JSP 容器 忽略 表达 式 语言 *$ {)”。 其 值 只 能 是 true 或 
false。 设 置 为 true, 则 忽略 表达 式 语言 ;设置 为 false, 则 不 忽略 表达 式 语言 。 

(10) pageEncoding: 用 来 设置 JSP 页 字符 的 编码 ,默认 值 是 ISO-8859-1。 考 虑 到 需 
要 支持 中 文 显示 ,可 以 将 该 值 设 置 为 UTF-8 gb2312 或 者 GBK。 


242 incude 指令 


include 指令 用 于 将 另外 一 个 文本 文件 .HTML 文件 或 JSP 文件 插入 到 当前 的 JSP 
页 面 中 。 利 用 include 指令 可 以 实现 页 面 的 模块 化 设计 ,例如 在 留言 板 实例 中 ,每 个 页 面 
的 导航 部 分 和 版 权 都 是 相同 的 :此 时 利用 include 指令 简化 设计 过 程 。 由 于 使 用 了 
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include 指令 , 当 需 要 修改 留言 板 的 导航 或 版 权 部 分 时 ,只 需要 修改 一 个 JSP 文件 ,所 有 页 
面 的 导航 或 版 权 部 分 都 会 更 改 , 具 体 用 法 参见 代码 2-6 所 示 。include 指令 的 语法 格式 
如 下 : 


<se include file= "被 包含 文件 的 URL" $> 


代码 2-6 利用 include 指令 简化 留言 板 的 设计 


< !-— header.html -一 > 
<html> 
<head> < /head> 
<body> 
< ing src- "-Vimages/logo.Png"/> 
< /body> 
< /html> 


< 上 -- footer.jsp --> 
< $@ page language= "java" import- "java.util. * " pageEnooding= "UTF- 8"%> 
<html> 
<head> 
<title> footer< /title> 
< /head> 
<body> 
<hr/> 
<div aligr= "oanter" "> gocpy; 辽 宁 石油 化 工大 学 2012 年 < /div> 
< /body> 
</htm> 


<!--ntes.jsp --> 
< $@ page language= "java"pageFEnooding= "UTF- 8"%> 
<html> 
<head> 
<title> 留 言 板 < /title> 
< /heac> 
<body> 
< %@ include file= "header.html" %> 
<div> 
<ul> 
<1i> 这 是 留言 板 的 主体 部 分 ,在 notes.jsp 中 实现 < /1> 
<1i> 导 航 部 分 放 在 header.htm 中 < /li> 
<1 记 版权 部 分 放 在 footer.jsp 中 < /1i> 
</u> 
</div> 
<%@ include file= "footer.jsp" $> 
< /body> 
< /hinl> 
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代码 执行 结果 如 图 2-6 所 示 。 


EEE3 
€ FC |®127.0.0.1:6080/jsp/2-5 有 


Ts 


。 这 是 留言 板 的 主 件 部 分 ， i jap 中 实现 
。 导航 部 分 放 在 header. html 中 
。 版 权 部 分 放 在 footcr. jsp 中 


5 辽宁 石油 化 工大 学 2012 年 


图 2-6 利用 include 指令 实现 页 面 模块 化 设计 


243 tagib 指 令 


当 用 户 希 望 在 JSP 页 面 中 使 用 第 三 方 或 自 定 义 的 标签 库 来 控制 信息 的 显示 时 ,需要 
使 用 taglib 指令 指明 标签 库 的 路 径 和 标记 前 级 。 所 谓 标签 库 ,是 一 种 通过 JavaBean 2 
基于 XML 的 脚本 的 方法 。 标 签 能 够 方便 地 从 一 个 JSP 项 目 迁 移 到 其 他 项 目 ,因此 一 
建立 了 一 个 标签 库 , 只 需要 将 所 有 的 东西 打包 为 一 个 JAR 文件 ,用 户 就 可 以 在 任何 Jsp 
项 目 中 重新 使 用 。taglib 的 格式 如 下 : 


< $@ taglib uri= "OURTToTagLibrary" prefix= "tagPrefix" %> 

其 中 ,uri 属性 指定 标签 库 的 位 置 ;prefix 属性 指定 一 个 在 页 面 中 使 用 该 标签 库 中 的 
标签 的 前 级 。 前 缀 不 能 命名 为 jsp .jspx java javax\sun ,servlet 和 sunw。 

关于 利用 taglib 引用 标签 库 的 具体 用 法 将 在 Struts 2 标签 库 部 分 讲述 。 


25 JSP 的 动作 标签 


动作 标签 是 一 种 特殊 的 标签 , 它 影 响 JSP 运行 时 的 功能 。 常 见 的 JSP 动作 标签 包括 
一 jsp:include 二 一 jsp:param 二 、 一 jsp:forward 盖 、 一 jsp:plugin 二 和 一 jsp:useBean 二 等 。 

过 jsp:plugin 记 动作 标签 用 于 指示 JSP 加 载 利 用 Applet 编写 的 插件 。 由 于 Applet 
现在 使 用 得 越 来 越 少 , 二 jsp:plugin 二 标签 已 经 很 少 使 用 。 

二 jsp:useBean 祖 动作 标签 用 于 加 载 一 个 JavaBean ,将 在 第 3 章 学 习 它 。 


251 <jspinclude> 动作 标签 

二 jsp:include 记 动作 标签 负责 把 指定 文件 插入 正在 生成 的 页 面 。 其 语法 如 下 : 
<jsp:include page= 文 件 的 URL " flush= "troe" /> 

到 jsp:include 之 动作 标签 和 前 面 介绍 过 的 include 指令 的 功能 有 些 相 似 。 当 Web 应 


用 程序 中 各 个 页 面 的 某 些 部 分 (例如 标题 ,页 脚 和 导航 栏 ) 都 相同 的 时 候 , 既 可 以 使 用 
include 指令 ,也 可 以 使 用 二 jsp:include 记 动作 标签 简化 页 面 的 设计 。 不 同 的 是 ,include 
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指令 采用 的 是 一 种 静态 包含 方式 , 即 在 JSP 文件 被 转换 成 Servlet 的 时 候 将 被 包含 的 文 
件 插入 当前 页 面 ;而 志 jsp:include> 动 作 标签 采用 的 是 一 种 动态 包含 方式 ,插入 文件 的 时 
间 是 在 页 面 被 请 求 的 时 候 。 

因此 ,当代 码 2-6 中 的 footer. jsp 发 生变 化 时 ,只 有 重新 将 notes. jsp 转译 成 Java 文 
件 (将 该 页 面 重新 保存 ,再 访问 ,就 可 以 产生 新 的 Java 文件 ) ,否则 在 客户 端 浏览 notes. 
jsp 时 只 能 看 到 修改 前 的 footer. jsp 内 容 。 如 果 将 语句 二 %@ include file 一 "footer. jsp" 
% 二 修改 成 二 jsp:include page 二 "footer. jsp" flush 二 "true" /二 ,在 footer.jsp 发 生变 化 
后 ,客户 端 在 浏览 notes. jsp 时 就 会 看 到 footer. jsp 修改 后 的 内 容 。 

过 jsp:include 记 动作 标签 引入 文件 的 时 间 决 定 了 它 的 效率 要 稍微 差 一 点 ,并 且 被 引 
用 文件 不 能 包含 某 些 JSP 代码 (例如 不 能 设置 HTTP 头 ) ,但 它 的 灵活 性 要 好 得 多 。 


252 <jspforverd> 动 作 标签 

去 jsp:forward 一 动作 标签 负责 将 客户 的 请 求 重 定 向 到 另外 的 页 面 或 Servlet 中 。 其 
语法 格式 如 下 : 

<jsp:forward page= {' 了 文件 的 URL "| "< $=expression $>"} /> 

其 中 ,jsp:forward 记 动作 标签 只 有 一 个 属性 page。page 属性 包含 的 是 一 个 相对 
URL。page 的 值 既 可 以 直接 给 出 ,也 可 以 在 请 求 的 时 候 通 过 动态 计算 获得 ,例如 : 

< jsp:forward page= "/manager/login.jsp" /> 

< jsp:forward page= "< $= sameJavaExpression %$>" /> 

253 <jspparanP 动 作 标签 

二 jsp:param 祖 动作 标签 负责 传递 一 个 或 多 个 参数 到 指定 的 文件 中 ,通常 与 过 jsp: 
include 二 一 jsp:forward 二 和 二 jsp:plugin 二 等 一 起 使 用 ,语法 格式 如 下 : 

< jsp:param name= "paranrName" value= "paranValue"/> 


其 中 ,paramName 表示 参数 的 名 称 ;paramValue 表示 参数 值 。 

代码 2-7 给 出 了 两 个 页 面 index. jsp 和 index2. jsp。 当 客户 端 访问 页 面 index. jsp 
时 ,服务 器 会 自动 将 请 求 转 到 页 面 index2. jsp, 同 时 将 两 个 参数 username 和 now 的 值 一 
起 传递 给 页 面 index2. jsp。 在 页 面 index2. jsp 中 可 以 利用 JSP 的 内 置 对 象 request 调用 
getParameter 方 法 获取 参数 的 值 。 


代码 2-7 带 有 参数 传递 的 forward 动作 


< !-— index.jsp --> 
< $@ page language= "java" import= "java.util. * " PagsEnoodingr- "utf- 8"%> 
<htm> 

<head> < title> index< /title> 

< /head> 

<body> 
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< SCalendar c= Calendar.getInstance (); 
String now= c.getTime () -taLocaleString () 
3> 
< jsp:forward page= "index2.jsp"> 
< jsp:param value= "Snith" name= "username"/> 
< jsp:param value= "< $= nom&> " name= "now"/> 
< /jsp:forward> 


< !-— index?.jsp 一 > 
< $@ page language= "java" pageEncodingr- "utf- 8"%> 


<html> 
<head> 
<title> welome< /title> 
< /head> 
<body> 
< 
String username= request .getParameter ("username"); 
String now= request .getParameter ("now"); 
%> 
<h2> ”欢迎 你 ,<$=username s> 现 在 时 间 是 : <s= now s>< /h2> 
< /body> 
< /html> 


代码 2-7 的 运行 效果 如 图 2-7 所 示 。 请 读者 注意 观察 图 中 的 URL 和 页 面 标题 。 


国 relecone x 
€ CGI127.0.0.1:8080/jsp/2-?/inder. jsp 家 | 六 


欢迎 你 ，Smith 现在 时 间 是 : 2012-7-14 16:39:50 


图 2-7 带 有 参数 传递 的 forward 动作 运行 效果 


26 JSP 的 内 置 对 象 


为 了 方便 Web 应 用 程序 的 开发 ,JSP 提供 了 9 种 内 置 对 象 : request、response、out、 
session、application、config、pageContext、page 和 exception。 这 些 内 置 对 象 在 JSP 页 面 
中 可 以 直接 使 用 ,程序 员 不 需要 对 其 实例 化 。 其 中 ,最 重要 的 对 象 为 request、response 和 


session 。 


261 out 对象 


out 对 象 是 类 javax. servlet. jsp. JspWriter 的 实例 ,主要 作用 是 在 Web 浏览 器 内 输 
出 信息 。 例 如 ,语句 
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<sout.println("<hl> 欢 迎 使 用 留言 板 程序 < /hl> ");%> 
在 运行 时 将 向 当前 JSP 页 面 输出 一 条 文本 信息 ,并 以 一 级 标题 形式 显示 。out 对 象 提 供 
了 两 个 方法 向 客户 端 输出 内 容 : print() 和 println()。 需 要 注意 的 是 ,在 Java 脚本 中 ,out 
对 象 的 println() 方 法 不 会 输出 换行 符 。 要 实现 换行 功能 ,可 以 使 用 以 下 语句 : 

<scut.println("<hl> 欢 迎 使 用 留言 板 程序 < /hl> <br/> ");%> 

在 JSP 页 面 中 ,可 以 通过 out 对 象 调用 clear() 方 法 清除 缓冲 区 中 的 内 容 。 这 类 似 于 
重 置 响应 流 ,以 便 重新 开始 操作 。out 对 象 用 于 管理 啊 应 缓冲 区 的 方法 如 表 2-1 所 示 。 

表 2-1 out 对 象 常用 的 管理 响应 缓冲 区 的 方法 


方 法 说 明 
clear() 清空 缓冲 区 
clearBuffer() 清空 当前 区 的 内 容 
close() 先 刷新 流 , 然 后 关闭 流 
flush() 刷新 流 
getBufferSize() 以 字 节 为 单位 返回 缓冲 区 的 大 小 
getRemaining() 返回 缓冲 区 中 没有 使 用 的 字符 的 数量 
isAutoFlush() 返回 布尔 值 ,自动 刷新 还 是 在 缓冲 区 溢出 时 抛 出 IOException 异常 
262 request 对 象 


request 对 象 是 接口 javax. servlet. http. HttpServletRequest 的 一 个 实例 ,是 最 重要 
的 服务 器 对 象 之 一 。 在 搜索 引擎 或 用 户 注 册 等 程序 中 ,客户 端 一 般 通过 HTML 表单 或 
是 在 URL 后 面 添加 参数 的 方法 向 服务 器 端 提交 数据 。 这 些 数 据 被 封装 在 HTTP 协议 
报 文中 ,利用 request 对 象 可 以 访问 HTTP 头 和 封装 的 请 求 信息 。 

request 对 象 最 常用 的 功能 是 用 于 获取 封装 在 HTTP 报 文中 的 请 求 数据 。 前 面 举 过 
一 个 关于 表单 的 例子 ( 见 代 码 2-4) ,现在 编写 一 个 doReg. jsp 页 面 完 成 对 表单 提交 的 数 
据 的 接收 和 处 理 , 参 见 代 码 2-8。 


代码 2-8 doReg. jsp 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 
< 
// 设 置 request 字 符 编码 
request. .setCharacterFnooding ("utf- 8"); 
/获取 客户 请 求 参数 


String[] favorite= request .getParameterValues ("favoritem) ; 
String intror request .getParameter ("intro"); 
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// 本 处 仅 打印 出 接收 到 的 信息 
out.println(" 用 户 名 : "); 
out.println (nsernamet "< br/> "); 
cut-println( 喀 码 : "); 
out.println (passwordt "cbr/> "); 
cut.printin(" 重 新 密码 : "); 
out .printin (password2+ "< br/> 四; 
cut-println (性别 : "); 
cut.println (gendert "<br/> "); 
out.printin( 学 历 : "); 
cout.println (educationt "< br/> "); 
cut.printin(" 最 喜爱 的 运动 : "); 
for (int i= 0;i< favorite.length;i+ + ){ 
out.println (favorite[i]+ " "); 

} 
out.printIn("< br/> "); 
out.printin(" 简 介 : "); 
out.println (introt "<br/>"); 

%> 


代码 2-8 中 的 request. getParameter(String name) 用 于 获得 客户 请 求 中 的 数据 。 参 
数 name 与 表单 中 对 应 控件 的 name 属性 相同 ,或 者 与 提交 URL 的 参数 名 相同 。 如 果 参 
数值 不 存在 ,返回 null 值 。 该 方法 的 返回 值 类 型 是 String。 

当 表单 中 存在 多 个 与 name 相同 的 控件 (例如 checkbox) ,或 者 URL 中 存在 多 个 同 
名 传递 参数 时 ,需要 使 用 方法 request. getParameterValues(String name) 获 取 所 有 的 值 。 
该 方法 的 返回 值 类 型 是 String[ ]。 

另外 ,request 对 象 还 提供 了 一 个 getParameterNames() 方 法 。 利 用 该 方法 可 以 获得 


客户 端 传送 给 服务 器 端的 所 有 参数 的 名 字 , 其 结 
果 是 一 个 枚 举 类 型 的 数据 。 园 lzroo Leomo/jspaoker x 


名 |@@127.0.0.1:s08o/jsp/dcReg. jsp 家 | 色 


注意 : doReg. jsp 中 的 第 4 行 request. 
setCharacterEncoding("utf-8") 的 作用 是 对 客户 
端 请 求 进行 重新 编码 ,用 于 解决 中 文 乱码 问题 。 | 386。 ，,， 

图 2-8 给 出 了 代码 2-8 的 运行 结果 ,其 中 的 | 各 介 ， 我 是 一 只 小 儿 纤 ， 我 喜 次 吃 免 了 | 
数据 对 应 图 2-4 中 的 数据 。 

利用 request 对 象 可 以 获得 客户 端的 IP 地 2-8 ”代码 2-8 运行 结果 
址 .请 求 的 URL 等 。request 对 象 常用 的 方法 如 
表 2-2 所 示 。 


表 2-2 request 对 象 常用 的 方法 
方 法 说 明 
getAttributeNames() 返回 request 对 象 所 有 属性 的 名 字 ,返回 类 型 Enumeration 
setAttribute(String name,Object value) | 设 定名 字 为 name 的 属性 , 值 为 value 
getAttribute(String name) 返回 name 指定 的 属性 值 。 若 不 存在 ,返回 null 
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续 表 
方 法 说 明 
getCookies() 返回 客户 端的 Cookies 对 象 ,返回 类 型 Cookie[] 
getHeader(String name) 获得 HTTP 协议 定义 的 文件 头 信 息 
> 返回 指定 名 字 的 request Header 的 所 有 值 ,返回 一 个 类 型 
getHeaders(String name) 为 Enumeration 的 实例 
返回 所 有 request Header 的 名 字 , 返回 一 个 类 型 为 
getHeadersNames() Enumeration 的 实例 
2 获得 客户 端 向 服务 器 端 传送 数据 的 方法 , 如 get、 post 
和 header 
getProtocol() 获得 客户 端 向 服务 器 端 传送 数据 所 依据 的 协议 名 称 
getRequestURI() 获得 发 出 请 求 字符 串 的 客户 端 地 址 
getRealPath() 返回 当前 请 求 文件 的 绝对 路 径 
getRemoteAddr() 获取 客户 端的 IP 地 址 
getRemoteHost() 获取 客户 端的 机 器 名 称 
getServerName() 获取 服务 器 的 名 字 
getServerPath() 获取 客户 端 所 请 求 的 脚本 文件 的 文件 路 径 
getServerPort() 获取 服务 器 的 端口 号 


代码 2-9 利用 request 对 象 获取 了 客户 端 和 服务 器 端 信息 。 


代码 2-9 获得 客户 端 和 服务 器 端 信息 


<S$@ page language= "java" import= "java.util. * " pageFnooding= "UTF- 8"%> 


<html> 
<head> 


<title> 客 户 端 和 服务 器 端 信息 < /title> 


< /head> 
<body> 


<h3> 客 户 端 信息 < /h3> 
客户 端 发 出 请 求 所 用 协议 : < $= reguest.getProtocol 0) $><br/> 


< 


客户 端 计算 机 的 下 地 址 :< $= request.getRemoteAcdr() %$><br/> 
客户 端 计算 机 的 主机 名 :< $= request.getRemoteHost () $><br/> 
客户 端 计算 机 使 用 者 :< $= regnest.getRempteUser() $><br/> 
客户 端 计算 机 请 求 体 的 MDE 类 型 :< $= request.getcontentType() $><br/> 
客户 端 计算 机 请 求 所 用 的 设置 :< $= request.getscheme() $><br/> 
客户 端 计算 机 请 求 所 用 的 方法 :< $= request.getMethod() $><br/> 
客户 端 计算 机 请 求 中 包含 的 字符 串 : 
< $= request .getQueryString() $><br/> 
客户 端 计算 机 请 求 的 URI:< $= request.getRequestURI() $><br/> 
客户 端 请 求 中 包含 的 头 信息 : 


Enumeration er request .getHeaderNames (); 
while(e.hasMbreFlements()){ 


第 2 章 _ JSP 基本 语法 5 


String headerName= e.nextFlement () -toString(); 
cut.Println ("< br> "+ headerNamet ":"); 
cut.Println (request.getHeader (headerNeme) ); 


S> 

<h3> 服 务 器 端 信息 < /ha> 

< 名 
String Fathr request .getContextPath(); 
String basePath= reqnest.getScheme ()+ "://" reqyest .getServerNere ()+ 

":"+ request .getServerPort ()+ Patht "/";» 

S> 
服务 器 端的 环境 路 径 :< 和 Path s><br/> 
当前 执行 的 se 的 路 径 信息 : <%= request.getServletFath () $><br/> 
服务 器 端的 根 路 径 URI:< $=basePath %> 

< /body> 
< /html> 


图 2-9 给 出 了 代码 2-9 的 运行 结果 。 


EE TT 
和 © | © 127.0.0.1:8080/j 


客户 端 信息 


bel ha det HITP/L.1 
疯 计 算 机 的 IP 地 址 :127. 0, 0.1 
Dn :127.0.0.1 


请 
求 所 用 的 方法 :CET 
提交 和 Tueernane=zhangzan 
求 的 TRI: nd 2. jsp 


lozilla/5.0 (Windows NI 5.1) AppleWebkit/536,5 (KHINL, like Gecko) Carome/19.0,1084,56 Safari/536,5 
accept: text/html epplioation/zhtnl+xml application/xnl, «=0. 90, 4/+,q-0.8 
accept-encading: deflate, sdch 
accept-Languag， 
accept-charset; GBK，utt-8q-0.T, 二 cc0.3 
cockie: ]S5SSIONTD=40456CDE8246p9D19D613CBAF95TEE93 


服务 器 端 信息 
人 


当前 执行 的 JSP 的 路 径 信息 ， /3-2. 
服务 器 江 的 根 路 径 URI:htt://127 G0.1:8080/isp/ 


图 2-9 代码 2-9 运行 结果 


263 response 对 象 


response 对 象 封 装 服务 器 处 理 数据 后 产生 的 结果 ,并 将 其 传 回 到 客户 端 , 用 于 响应 
客户 的 请 求 。response 对 象 是 接口 javax. servlet. http. HttpServletResponse 的 一 个 实 
例 。 利 用 response 对 象 ,可 以 设置 HTTP 标题 ,设置 响应 内 容 的 类 型 和 状态 ,发 送 
HTTP 重 定向 和 编码 URL 等 。 

response 对 象 的 常用 方法 如 表 2-3 所 示 。 
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表 2-3 response 对象 的 常用 方法 


方法 说 明 
addCookie(Cookie cookie) 添加 一 个 Cookie 对 象 ,用 于 在 客户 端 保存 特定 的 信息 
addHeader(String name, String value) 添加 HTTP 头 信息 ,该 Header 信息 将 发 送 到 客户 端 
containsHeader(String name) 判断 指定 名 字 的 HTTP 文件 头 是 否 存在 
sendError(int) 向 客户 端 发 送 错误 的 信息 
sendRedirect(String url) 重 定 向 JSP 文 件 
setContentType(String contentType) 设置 MIME 类 型 与 编码 方式 


代码 2-10 给 出 了 一 个 留言 板 程序 的 登录 页 面 ,用 户 在 输入 完 用 户 名 username 和 密 
码 password 后 ,通过 登录 按钮 将 数据 发 送 给 doLogin. jsp 进行 处 理 。 


代码 2-10 留言 板 登录 程序 


< !-- login.jsp 文 件 源码 --> 
< $@ page contentType= "text/html; charset= utf- 8" language= "java"®> 
<html> 
<head> 
<title> 登 录 < /title> 
< /head> 
<body> 
< form action= "doLogin.jsp" method= "post"> 
用 户 名 : < input type= "text" name= "username" /><br /> 
密 anbep;snbep; 码 : < inptt type= "password" name= "password" /><br /> 
< input type= "submit" value= " 品 录 " /> 
< /fom> 
< /body> 
</html> 


< !-- doLogin.jsp 文 件 源码 --> 
< $@ page language= "java" pageEnooding= "UIF- 8"%> 
过 条 
// 设 置 request 字 符 编码 
request..setCharacterEnooding ("utf- 8"); 
/获取 客户 请 求 参数 
String request .getParameter ("usemame"); 
String password= request .getParameter ("password"); 
if (usemame.equals(" 张 三 ") && password.equals ("123")){ 
// 将 用 户 名 保存 在 sessicn 中 
3ession.setAttribute ("usemame", usemame); 
// 重 定向 到 index.jsp 页 面 
response. sendRedirect ("index.jsp"); 


response. sendRedirect ("Jogin.jsp"); 
%> 
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很 多 读者 都 访问 过 基于 网 页 的 聊天 室 。 为 了 显示 最 新 的 聊天 内 容 , 聊 天 室 程 序 需要 
定时 刷新 页 面 内 容 。 这 一 功能 可 以 通过 response 对 象 设置 HTTP 头 信息 来 完成 。 


代码 2-11 ”response 对 象 设置 HTTP 头 信息 


< $8 page language= "java" import= "java.util.Date" pageEnooding= "UTF- 8"%> 
<htm> 
<head> 
<title> response 刷 新 页 面 < /title> 
</head> 
<body> 
<b> 当 前 时 间 为 : < /b> 
< 
response.setHeader ("refresh", "20"); 
ut .printIn (new Date ()); 
%> 
< /body> 
</htm> 


代码 2-11 实现 了 定时 刷新 页 面 , 每 隔 20 秒 钟 客户 端 重新 发 送 获 取 页 面 请 求 。 程 序 
运行 效果 如 图 2-10 和 图 2-11 所 示 。 


国 response 刷 新 页 面 x 国 response 刷 新 页 面 \ 
€ 名 1@ 127.0.0.1:8080/jsp/3-5. jsp 容 | € © | © 127.0.0.1:8080/jsp/3-5. jsp 安 | 


当前 时 间 为 。 Fri Jun 22 16:18:16 CST 2012 当前 时 间 为 。 Fri Jun 22 16:18:36 CST 2012 


图 2-10 代码 2-11 的 运行 结果 图 2-11 20 秒 后 更 新 的 结果 
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session 对 象 用 于 存储 特定 的 用 户 会 话 所 需 的 信息 。 用 户 从 到 达 Web 服务 器 的 某 个 
特定 的 Web 页 开始 ,到 该 用 户 离开 Web 站 点 的 整个 过 程 称 为 一 次 会 话 。 

引入 session 对 象 是 为 了 弥补 HTTP 协议 的 不 足 。HTTP 协议 是 一 种 无 状态 的 协 
议 。 无 状态 是 指 协议 对 于 事务 处 理 没有 记忆 能 力 , 这 种 无 状态 意味 着 如 果 后 续 处 理 需 要 
前 面 操 作 产 生 的 数据 ,必须 将 该 数据 在 服务 器 和 客户 端 之 间 重 传 。 为 了 保持 HTTP 之 间 
的 连接 状态 ,产生 了 两 种 交互 技术 : cookie 和 session。cookie 是 通过 客户 端 保存 状态 的 
方案 ,session 是 通过 服务 器 来 保持 状态 的 解决 方案 。session 对 象 可 以 让 用 户 在 一 个 
Web 站 点 的 多 个 页 面 之 间 共 享 少量 的 信息 。 在 实际 应 用 中 ,session 对 象 经 常 被 用 于 存 
储 登 录用 户 的 信息 以 及 实现 购物 车 等 。 

需要 注意 的 是 ,JSP 容器 会 为 每 个 会 话 用 户 都 设立 一 个 独立 的 session 对 象 , 用 以 存 
储 session 变量 。 各 个 用 户 的 session 对 象 互 不 干扰 。 

session 对 象 是 javax. servlet. Http. HttpSession 接口 的 一 个 实例 ,常用 的 方法 如 
表 2-4 所 示 。 
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表 2-4 session 对 象 的 常用 方法 


方 法 说 明 
setAttribute(String name,Object value) | 设 定名 字 为 name 的 属性 , 值 为 value 
getAttribute(String name) 获得 指定 名 字 的 属性 。 如 果 该 属性 不 存在 , 则 返回 null 
removeAttribute(String name) 删除 名 为 name 的 属性 
invalidate() 销毁 session 对 象 


判断 当前 session 是 否 为 新 的 session。 若 是 ,返回 true; 否 
则 ,返回 false 

设置 session 对 象 的 有 效 时 间 ( 也 称 作 最 长 不 活动 时 间 、 超 
setMaxInactiveInterval(int interval) 时 时 间 ), 时 间 单 位 为 秒 。 所 谓 有 效 时 间 , 是 指 连续 两 次 客 
户 请 求 之 间 的 最 长 时 间 ,超过 这 个 时 间 ,session 将 失效 


getMaxJInactiveInterval() 获取 session 对 象 的 最 长 不 活动 时 间 ,时 间 单 位 为 秒 


isNew() 


在 代码 2-10 中 ,doLogin. jsp 文件 第 10 行 代码 演示 了 如 何 利用 session 保存 用 户 登 
录 信 息 。 代 码 2-12 演示 了 利用 session 保存 的 信息 进行 登录 验证 。 


代码 2-12 留言 板 首 页 (index.jsp) 


String username= null; 
if (null!= session.getAttribute ("username")) 
username= sessicn.getRttribute ("usermame") .toString(); 
%> 
<html> 
<head> 
<title> 留 言 板 程序 < /title> 
< /head> 
<body> 
<%if ==Uusername) {%> 
您 尚未 <a hreE- "login.jsp> 登 录 </a>! 
<%jelsef $> 
欢迎 < font color= "red"> < 和 -username s>< /font> 使 用 留言 板 程序 
<%} $> 
< /body> 
</html> 


代码 2-10 和 代码 2-12 共同 完成 了 留言 板 程序 的 登录 部 分 。index. jsp 页 面 对 用 户 进 
行 登录 验证 ,未 登录 用 户 看 到 的 是 “您 尚未 登录 ”字样 。 一 旦 用 户 登录 后 ,无 论 是 从 其 他 
页 面 转 回 到 inex. jsp, 还 是 利用 刷新 按钮 刷新 index. jsp 页 面 ,都 将 看 到 “欢迎 XX 使 用 留 
言 板 程序 ”字样 ,其 中 的 “XxX X” 为 当前 登录 的 用 户 名 。 

提醒 一 下 读者 ,session 对 象 在 以 下 两 种 情况 下 失效 。 

(1) 超过 session 对 象 的 有 效 期 ; 

(2) 显 式 调用 invalidate() 方 法 。 

session 的 有 效 期 也 可 以 在 web. xml 中 配置 。 例 如 ,下 面 的 语句 将 session 有 效 期 设 
置 为 60 分 钟 。 


< session -config> 
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< session- timeout> 60 /session- timecut> 


< /session- config> 


下 面 讲述 JSP 中 session 实现 的 原理 。 

每 当 服务 器 接收 到 一 个 客户 端 请 求 时 ,首先 检查 该 客户 端的 请 求 里 是 否 包 含 一 个 
session 标识 (JSESSIONID)( 见 图 2-12)。 如 果 包 含 一 个 session ID, 说 明 以 前 为 此 客户 
端 创建 过 session ,于 是 服务 器 从 内 存 中 按照 session ID 检索 出 session( 如 果 检 索 不 到 ,可 
能 会 新 建 一 个 ) ;如 果 客 户 端 请 求 中 不 包含 session ID ,服务 器 会 认为 当前 客户 端 发 起 了 
新 的 会 话 , 会 为 该 客户 端 创建 新 的 session 并 生成 与 此 session 相关 联 的 session ID。 这 
个 session ID 将 在 本 次 响应 中 返回 给 客户 端 保存 。 以 后 ,客户 端 将 利用 该 session ID 作 
为 会 话 的 凭证 ,即使 浏览 器 被 关闭 ,只 要 使 用 某 种 手段 改写 浏览 器 发 出 的 HTTP 请 求 头 ， 
把 原来 的 session ID 发 送 给 服务 器 , 青 次 打开 浏览 器 时 ,仍然 能 够 找到 原来 的 session。 


Request Headers 


Accept text/htal, applicaticn/zhtalrzal application/zal:q=0.9 #/*:q=0.8 


Cookde JSESSTONTD=OAgE486C855D455620DDD9BPACT1DCCA 
Host 127.0.0.1:8080 
Referer http://127.0.0. 1:8080/Login/serviet/Loginserviet 
User-Agent Morilla/5.0 (Windows NT 5.1; rw:13.0) Gecko/20100101 Firefox/13.0.1 


图 2-12 Request 头 部 中 包含 的 JSESSIONID 
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与 session 对 象 类 似 ,application 对 象 也 用 于 存储 和 访问 来 自任 何 页 面 的 变量 。 不 
同 之 处 在 于 ,session 对 象 和 用 户 的 关系 是 一 一 对 应 的 ,用 来 记录 用 户 的 个 人 信息 ; 
application 对 象 则 被 所 有 的 用 户 共 享 ,用 来 记录 全 局 的 信息 。 

与 session 对 象 类 似 ,application 对 象 也 可 以 保存 属性 和 属性 的 值 。session 对 象 中 
保存 的 属性 只 在 用 户 当前 会 话 范围 内 有 效 , 一 旦 会 话 结束 或 者 会 话 超过 最 大 不 活动 时 
间 ,session 对 象 将 被 销毁 ;而 在 application 对 象 中 保存 的 属性 在 整个 应 用 程序 范围 内 是 
有 效 的 ,即使 所 有 的 用 户 都 不 发 送 请 求 , 只 要 不 关闭 或 重启 应 用 服务 器 ,在 其 中 保存 的 属 


性 都 是 有 效 的 。 
application 对 象 是 javax. servlet. ServletContext 接口 的 一 个 实例 ,常用 的 方法 如 
表 2-5 所 示 。 
表 2-5 application 对 象 的 常用 方法 
方 法 说 明 


setAttribute(String name, Object value) 


在 application 对 象 中 保存 一 个 名 字 为 name 的 属性 , 值 为 value 


getAttribute(String name) 


获取 指定 的 属性 值 。 如 果 该 属性 不 存在 , 则 返回 null 


getAttributeNames() 


获取 所 有 可 用 属性 名 ,返回 类 型 为 一 个 Enumeration 类 型 
实例 


removeAttribute(String name) 


从 application 中 删除 名 为 name 的 属性 


ServletContext getContext(String uripath) 


获取 指定 URL 的 ServletContext 对 象 
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下 面 通过 一 个 网 页 访问 次 数 计数 器 的 例子 来 说 明 application 对 象 的 使 用 方法 ,如 代 
码 2-13 所 示 。 


代码 2-13 ”网 页 访问 计数 器 (applicationCount. jsp) 


< $@ page language= "java" pageEnooding= "UTE- 8"%> 
< 
int oont= 0; 
/人 从 applicaticn 对 象 中 取得 已 经 访问 次 数 count 
Cbject or application.getAttribute ("count"); 
if(mll!=0) 
count= Integer .parseInt (0.tostring()); 
// 访 问 次 数 加 1 
Count+ 十 了 
/将 访问 次 数 保存 到 applicaticn 对象 中 
application.setRttribute ("ount", String.valueOf (oount)); 
名 > 
<html> 
<head> 
<title> 网 页 访问 计数 器 < /title> 
< /head> 
<body> 
当前 网 页 的 访问 次 数 为 :<%= count %> 
< /body> 
< /himl> 


代码 2-13 在 Google Chrome 浏览 器 中 的 运行 结果 如 图 2-13 所 示 。 


网 页 访问 计数 器 
€ 3 © 127.0.0.1:8080/jsp/applicationcount. jsp 安 | 


当前 网 页 的 访问 次 数 为 ，1 


图 2-13 applicationCount. jsp 运行 结果 


在 Google Chrome 浏览 器 中 ,页 面 刷新 3 次 后 ,利用 Mozilla Firefox 浏览 器 查看 到 
的 结果 如 图 2-14 所 示 。 
网 页 访问 计数 器 - Wozilla Firefox 


Eile Edit Yiew Jistery Boomarks Tools kelp 
国 网 访问 计数 器 - 


和 志 ) 园 127..0.0. 1:8080/jsp/applicati % 


当前 网 页 的 访问 次 数 为 ，5 


图 2-14 ”applicationCount. jsp 被 访问 第 5 次 的 结果 


重新 启动 Web 服务 器 后 ,再 次 浏览 applicationCount. jsp 的 运行 结果 如 图 2-15 所 
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示 。 尽 管 图 2-13 和 图 2-15 中 显示 的 网 页 访问 次 数 都 为 1, 但 二 者 访问 的 是 不 同 的 
application 对 象 中 的 属性 。 


国 网 页 访问 计数 器 
所 © | © 127.0.0.1:8080/jsp/applicationCount. jsp 窑 | 


当前 网 页 的 访问 次 数 为 ，1 


2-15 重启 Web 服务 器 后 ,applicationCount. jsp 运行 结果 


266 cooke 


cookie 是 由 Web 服务 器 保存 到 客户 端的 一 小 段 文本 信息 ,可 以 随 着 用 户 请 求 和 页 面 
在 Web 服务 器 和 浏览 器 之 间 传 递 。 现 在 很 多 网 站 在 用 户 浏览 或 者 下 载 信息 时 都 要 求 登 
录 。 有 时 登录 了 一 次 ,再 次 访问 该 站 点 时 ,会 自动 识别 出 用 户 ,这 是 因为 上 次 登录 的 信息 
保存 到 了 本 地 硬盘 中 , 当 用 户 再 次 访问 该 站 点 时 ,网 页 程序 通过 读 取 cookie 识别 出 了 用 
户 。 利 用 cookie 可 以 为 用 户 提供 个 性 化 服务 ,了 解 用 户 对 当前 网 站 的 浏览 习惯 。 

在 JSP 中 实现 跟踪 用 户 的 方法 通常 有 四 种 : 表单 的 隐藏 域 `.URL 参数 重 写 ,cookie 
和 session 会 话 。 关 于 前 两 项 方法 ,读者 可 以 自行 查阅 相关 文献 。session 和 cookie 的 区 
别 在 于 : session 对 象 保存 在 Web 服务 器 的 内 存 中 ,可 以 保存 普通 类 型 的 数据 或 者 是 一 
个 JavaBean 对 象 , 当 信息 量 比较 大 时 会 影响 服务 器 的 性 能 :cookie 存放 在 客户 端的 硬盘 
上 ,保存 的 数据 只 能 是 字符 串 形 式 ,不 同类 型 的 Web 浏览 器 会 把 cookie 数据 保存 在 硬盘 
的 不 同 目录 下 。session 在 会 话 开始 时 生成 ,会 话 结束 或 超时 就 会 消失 ;cookie 可 以 长 期 
保存 在 客户 端 ,数据 失效 期 取决 于 生成 cookie 时 的 设置 。session 存放 在 服务 器 中 ,用 户 
不 能 绕 过 Web 程序 进行 修改 ;cookie 安全 性 较 差 ,用 户 可 以 分 析 存 放 在 本 地 的 cookie 并 
进行 cookie 欺骗 。 

严格 地 说 ,cookie 并 不 能 算是 JSP 的 内 置 对 象 。cookie 对 象 不 能 单独 使 用 ,必须 与 
request 对 象 或 response 对 象 结合 使 用 。 

cookie 对 象 的 常用 方法 如 表 2-6 所 示 。 


表 2-6 ”cookie 对 象 的 常用 方法 


方 法 说 明 
getName() 返回 cookie 的 名 字 
getValue() 返回 cookie 的 值 
setValue(String newValue) cookie 创建 后 设置 一 个 新 的 值 
setMaxAge(int Age) 以 秒 计算 ,设置 cookie 的 存在 期 限 


修改 代码 2-10 中 的 login. jsp 文件 源码 ,将 表单 的 action 属性 的 值 改 为 doLogin2. jsp。 
修改 doLogin. jsp, 在 用 户 登 录 时 将 登录 用 户 名 保存 到 cookie 中 ,如 代码 2-14 所 示 。 
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代码 2-14 ”增加 了 cookie 信息 的 登录 处 理 页 面 (doLogin2. jsp) 


< $@ page languager "java" pagsEnoodingr "UIE- 8"%> 
< 
request .setCharacterFnooding ("utf— 8"); 
String username= request .getParameter ("username"); 
String password- request .getParameter ("password") ; 
if (usemame.equals(" 张 三 ") sg password.equals ("123")){ 
// 生 成 一 个 cookie, 并 保存 登录 的 用 户 名 
Cookie cookie= new Cookie ("Username",username); 
// 设 置 cookie 的 有 效 期 为 秒 
cookie.setMaxAge (60); 
/将 cocokie 添 加 到 response 对 象 中 ,以 便 写 人 客户 端 
Tesponse.adacookie (cookie) 
response. sendRedirect ("index?2.jsp"); 
} 
else 
response. sendRedirect ("login.jsp"); 
%> 


修改 代码 2-12, 将 留言 板 首页 修改 成 代码 2-15 的 形式 。 新 的 留言 板 登录 程序 在 用 户 
访问 index2. jsp 时 会 读 取 cookie, 从 中 获得 保存 的 用 户 名 。 如 果 cookie 为 空 或 者 超过 了 
有 效 期 ,会 自动 重 定位 到 login2. jsp。 


代码 2-15 ”增加 了 读 取 cookie 信息 的 留言 板 首页 (index2. jsp) 


< $@ page language= "java" pageEnooding= "UIF- 8"%> 
< $@ page language= "java" pageEnooding= "UTF- 8"%> 
<% 

String username= null; 

// 得 到 所 有 的 cookies 

Cookie[] cookies= request..getCookies(); 

// 如 果 设 置 了 cockie, 得 到 它 的 值 

if(cookies!=nu11) { 

for(int i=0;i< oookies.length;i++){ 
if (cookies [i] .getName () .equals ("usemame")) 
Username= oookies [i] .getValue (); 


$> 
<html> 
<head> 
<title> 留 言 板 程序 < /title> 
< /head> 
<body> 
<hi> 欢 迎 < font color= "red"><$=username s>< /font> 使 用 留言 板 程序 < /hl> 
< /body> 
< /html> 
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同步 训练 


1. 编写 一 个 建议 的 购物 车 程序 ,利用 session 保存 用 户 选 购 的 商品 信息 。 提 示 : 本 
序 可 以 包含 两 个 页 面 : 供 顾客 选 购物 品 的 buy. jsp 页 面 和 查看 购物 车 的 result. jsp 
2. 编写 一 个 网 页 版 聊天 室 程序 。 提 示 : 可 以 通过 设置 HTTP Header 实现 页 面 定时 
刷新 。 例 如 ,语句 response. setHeader("refresh","30") 将 网 页 刷新 间隔 定 为 30 秒 。 

3. 设计 一 个 留言 板 注册 页 面 , 分 别 利 用 Table 和 DIV 实现 页 面 布局 。 页 面 参考 样 
式 如 图 2-16 所 示 。 


程 
页 


到 


留言 板 一 注册 


图 2-16 留言 板 注册 页 面 样 例 
4. 编写 注册 信息 接收 页 面 , 接 收 注册 页 面 提交 的 所 有 信息 ,输出 到 浏览 器 中 。 


hapter 3 
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31 JavaBean 


311 编写 JaveBean 


JavaBean 是 用 Java 编写 的 组 件 , 每 个 JavaBean 实现 了 一 个 特定 的 功能 ,其 他 开发 者 
可 以 通过 JSP 页 面 \Servlet 来 使 用 这 些 对 象 。JavaBean 的 优点 在 于 提高 代码 的 重用 性 ， 
可 以 一 次 性 编写 ,任何 地 方 重用 。 

JavaBean 通常 具有 如 下 特点 。 

(1) JavaBean 类 必 是 一 个 public 类 。 

(2) JavaBean 的 属性 必须 为 private 类 型 。 

(3) 对 JavaBean 属性 的 操作 通常 由 两 个 public 类 型 的 方法 getXxx() 和 setXxx() 完 
成 。 其 中 ,getXxx() 方 法 用 于 获取 属性 xxx 的 值 ,setXxx() 方 法 用 于 设置 属性 xxx 的 值 。 

因为 JavaBean 本 质 上 就 是 一 个 Java 类 ,因此 可 以 在 JavaBean 中 定义 各 种 方法 。 但 
在 实际 的 JSP 程序 设计 时 ,通常 只 在 JavaBean 中 包括 构造 函数 和 属性 的 get/set 方法 。 

代码 3-1 声明 了 一 个 JavaBean 类 note. java。 


代码 3-1 实现 JavaBean 


//note.java 文 件 源 代码 

Package notes.model; 

Piblic class note { 
String title; 
String msgPerson; 
String content; 


Public String getTitle() { 

try{ 
byte b[]= title.getBytes ("ISO- 8859- 1"); 
title= new String(b); 
retum title; 

} catdh (Exosption e) { 
retum title; 

; 
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Public void setTitle (String title) { 
this.title=title; 


Public void setMsgPerson (String msgPerson) { 
this.msgPerson= msgPerson; 
E 
Public String getContent() { 
try{ 
byte b[]= content .getBytes ("TS0- 8859- 1"); 
content= new String (bP); 
retum oontent; 
} catdh (Exception e) { 
retum oontent; 
} 
} 
Public void setContent (String content) { 
this.content= ontent; 
} 


312 使 用 JaveBean 


要 在 JSP 页 面 中 使 用 编写 好 的 JavaBean, 需 要 先 在 JSP 页 面 中 创建 一 个 JavaBean 
的 实例 ,然后 才能 通过 该 实例 调用 JavaBean 定义 的 方法 。 使 用 JavaBean 的 方法 有 两 种 : 
一 种 是 利用 JSP 定义 的 二 jsp: useBean 二 动作 .二 jsp: setProperty 二 动作 和 二 jsp: 
getProperty 过 动作; 另 一 种 是 new 操作 显 式 地 创建 JavaBean 实例 。 下 面 逐 一 介绍 。 


1 标准 的 JaveBean 操作 动作 

(1) 一 jsp:useBean 二 动作 

二 jsp:useBean 记 用 于 在 JSP 页 面 中 创建 一 个 JavaBean 实例 ,语法 格式 如 下 : 

<jsp:useBean id= "bean 名 字 " soope= "page| request | session| application" 

class=" 哑 名 必 

其 中 : 

Q@ id 属性 用 于 定义 要 加 载 的 JavaBean 实例 的 名 称 。 使 用 该 名 称 可 以 引用 JavaBean 
的 属性 和 方法 。 

@) scope 属性 定义 JavaBean 的 生命 周期 ,默认 值 为 page. 表 示 该 JavaBean 只 在 当前 
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JSP 页 面 中 可 用 。 程 序 员 可 以 根据 需要 将 scope 设置 为 其 他 值 。 

@ class 属性 指定 要 加 载 的 JavaBean 的 类 文件 路 径 。 

(2) 一 jsp:setProperty 过 动作 

所 jsp:setProperty 二 动作 和 志 jsp:useBean 二 动作 配合 使 用 ,用 于 设置 JavaBean 的 属 
性 值 ,语法 格式 如 下 : 

< jap:setPraperty namer "beanname" property="* "> 
或 

< jsp:setProperty name= "beanname" property= "属性 名 " [paramr "参数 名 "]> 
或 

< jsp:setProperty name= "beanname" property= "属性 名 " value= "属性 值 "> 

其 中 : 

Oz name 属性 是 通过 一 jsp:useBean 二 动作 引入 的 JavaBean 实例 的 名 字 。 

@ property 属性 用 于 匹配 JavaBean 定义 的 属性 。 当 取 值 为 ** ”时 ,JSP 容器 会 自动 
将 request 中 各 参数 的 值 赋值 给 JavaBean 实例 中 的 同名 属性 ;如 果 request 中 的 属性 名 
与 JavaBean 中 的 属性 名 字 不 相同 ,必须 利用 param 指定 request 中 的 参数 名 。 

@ 格式 3 利用 value 的 值 来 设置 JavaBean 的 属性 值 。 

(3) 一 jsp:getProperty 二 动作 

二 jsp: getProperty 过 动作 也 必须 和 二 jsp:useBean 二 动作 配合 使 用 ,用 于 获取 
JavaBean 中 属性 的 值 ,所 得 到 的 值 会 自动 转换 成 字符 串 类 型 ,并 通过 输出 流 输出 到 JSP 
页 面 。 格 式 如 下 : 


< jsp:getProperty name= "beanname" property= "属性 名 "> 
各 属性 值 的 含义 和 二 jsp:setProperty 二 动作 中 属性 的 含义 相同 。 
代码 3-2 演示 了 如 何 利用 标准 的 JavaBean 操作 动作 访问 代码 3-1 中 定义 的 


JavaBean 。 


代码 3-2 使 用 JavaBean 


<!--post.jsp 文 件 源 代码 --> 
< $@ Page language= "java" import= "java.util. * " pageFnooding= "GB2312"%> 
<html> 
<head> 
<title> 留 言 板 程序 < /title> 
< /head> 
<body> 
< fom action= "showPost..jsp" mrthod= "post"> 
标题 :< input type= "text" name= "title" size= "80"/><br/> 
留言 人 :< input type= "text" name= "msgPerson" size= "80"> <br/> 
内 容 : 


< textarea rows= "20" cols= "70" name= "content"> < /textarea> <br/> 
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<input type= "simit" value= "留言 "/> 
< input type= "reset" value= " 重 写 "/> 
< /fom> 
< /body> 
< /html> 


< !-- showPost.jsp 文 件 源 代码 --> 
< $@ page languager "java" contentTyper "text/html; charset— GB2312"%> 
<htm> 
<head> 
<title> 显 示 留 言 < /title> 
< /head> 
<body> 
< jsp:useBean id "note" scoper "sessicn" class= "notes .model .note"/> 
< jsp:setProperty property= "* " name= "note"/> 
< oenter>< font color= "red"> 您 好 ,以 下 是 您 输入 的 留言 信息 : < /font> 
<hr/> 
留言 人 : < jsp:getProperty property= "msgPerson" namer "note"/><br/> 
题目 : <jsp:getProperty property= "title" nemer "note"/> <br/> 
内 容 : <jsp:getProperty property= "content" nemer "note"/> <br/> 
< /canter> < /body> 
< /html> 


在 JSP 程序 开发 中 ,如 果 通 过 表单 提交 的 数据 中 存在 中 文 , 则 获取 该 数据 后 输出 到 
页 面 时 会 显示 乱码 。 因 此 ,在 输出 获取 的 表单 数据 之 前 ,必须 进行 转 码 操作 。 前 面 曾经 
利用 request. setCharacterEncoding("utf-8") 进 行 过 转 码 , 但 是 当 使 用 二 jsp: setProperty 过 
动作 接收 数据 时 ,这 种 方法 不 会 发 挥 作用 ,这 时 可 以 将 该 转 码 操作 在 JavaBean 中 实现 ,如 
代码 3-1 所 示 。 

2 利用 new 操 作 实例 化 JaveBean 

JavaBean 类 可 以 像 普通 类 一 样 通过 import 语句 引入 JSP 文件 ,再 利用 new 操作 显 
式 创建 实例 。 

在 代码 3-3 中 ,给 出 了 显 式 实例 化 JavaBean 的 方法 。 这 里 重 写 了 note. java 类 ,更 名 
为 note2. java。note2. java 不 需要 使 用 getBytes("ISO-8859-1") 进 行 转 码 。 


代码 3-3 显 式 实例 化 JavaBean 


//note2.jeva 文 件 源 代码 
Package notes.model; 
Public class note2 { 
String title; 
String msgPerson; 
String content; 
Public String getTitle() { 
retum title; 
3 
public void setTitle (String title) { 
this.title=title; 


‘> Web 应 用 程序 开发 技术 一 JSP 十 Struts 2 


Public void setMsgPerson (String msgPerscn) { 
this.msgPerson— msgPerson; 


Public void setContent (String oontent) { 
this.content= content; 
} 
} 


< !- showPost2.jsp 文 件 源 代码 --> 
< $@ page language= "java" import= "notes.model .note2" pageEnooding= "UTF- 8"%> 
<htm> 
<head> 
<title> 显 示 留 言 < /title> 
< /head> 
<body> 
<% 
request. .setCharacterEnooding ("UIE- 8"); 
nOte2 mm new note2(); 
n.setTitle (request .getParameter ("title")); 
n.setMsgPerson (request .getParameter ("msgPerson")); 
n.setContent (request .getParameter ("content")); 


String title=n.getTitle(); 
String msgPerson= n.getMsgPerson(); 
String content= n.getContent (); 
$%> 
<center> < font color= "red"> 您 好 ,以 下 是 您 输入 的 留言 信息 : < /fcnt> 
<hr/> 
留言 人 :<%=msgPerson $><br/> 
题目 : <s=-titles><br/> 
内 容 : < 和 =- contents><br/> 
< /center> 
</body> 
</htm> 


32 Sevet 


321 ”SevMt 概念 


Servlet 是 运行 在 Web 服务 器 端的 Java 小 程序 ,可 以 生成 动态 的 网 页 。 在 基于 
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MVC 的 Web 程序 开发 中 ,通常 利用 Servlet 接受 客户 请 求 ,调用 业务 逻辑 处 理 的 方法 ， 
最 后 通过 HttpResponse 对 象 跳 转 到 相应 的 页 面 。 

Servlet 与 JSP 的 功能 相似 ,都 是 用 于 处 理 客户 请 求 并 返回 响应 。 事 实 上 ,对 于 每 一 
个 JSP 页 面 ,在 第 一 次 被 客户 访问 时 ,服务 器 都 会 将 其 转换 成 Servlet。 例 如 ,名 为 notes 
的 Web 工程 的 根 目录 下 有 个 post. jsp 页 面 ( 见 代码 3-2) ,其 对 应 的 Servlet 位 于 Tomcat 
主 目录 下 的 work\Catalina\localhost\notes\org\apache\jsp 子 目 录 中 ,名 为 post_jsp. 
java, 翻 译 后 的 内 容 如 图 3-1 所 示 。 


区 pozt_jsp- java - 记 学 本 


文件 虽 同 加 上 格式 四) 查看 外 和 玫 助 中 
public void _jspService(final javax.servlet.http.HttpSeruletRequest request, final javax.servlet.http.HttpServletR | 
throws java.io.10Exception, javax.serulet.ServletException 《 


final javax.servlet.jsp.PageContext payeContexts; 
javax.servlet.http.HttpSession session = null; 

Final javax.servlet.SeruletContext application; 

Flnal Javax.servlet.ServletconFly conf1g; 

jawax .Serulet-jsp-JspWriter out = nu 

Final java-lang.0bject page ~ hiss 

Javax. servlet .Jsp-Jspyriter _j5px_ouc = null; 

javax. servlet jsp-PageContext _jshx_page_context = null; 


try 《 
response.setContentType ("text/htnl;charset-UTr -9"); 
pageContext = jspxFactory.getPageContext(this, request, response, 
Null, true, B192, true); 
jspx_page_context ~ pageContext; 
pplication = pageContext.getseruletContext(); 
config = pagecontext-getSeruletconfig(); 
Session ~ pageContext.getsession(); 
out = pageContext .getOut(); 
jspx_out = out; 


out-urite("\r\n); 

out -urite( "ChtmL>NPVm') 

vut-urite cheag>\r 

out-urite(" <title; 程序 4/titleyArN): 
out -urite(" 《AheadyNr 

out,urite( Dogy> \r\n” 


out -urite(” <Fforn action-\"showPost?2.jsp\” method=\"post\">\r\n" 


ut .write(" anbsp; 题 :input type-\"te ne-\"title\" size-NvBgN"A》 xbrAyArNm') 
out .uitel” 人 1 gferson\ ”size=\"8gN“><Dr/2NN ) 3 
out urite(" enbsp :&nbsp ; 窑 : =V"28N” cols=\"70\" nano=\"content\">¢/toxtarea 
out-urite(”  \tCinput type-\"subnit\” val ; 
out.urite(”  \tCinput type=\reset\ ualuer 
out -urite(" 。 《/FormyNrNm' 3 
out :write(” khbedgyyNrNI 
out .urite("</htnl>\r\n"); 
} cateh (jaua-lang.Throwable t) 《 


在 


图 3-1 post. jsp 转换 得 到 的 post_jsp. java 代码 


Servlet 和 JSP 两 者 最 大 的 区 别 就 是 : Servlet 以 Java 程序 为 主 ,输出 HTML 代码 时 
需要 使 用 out. println 函数 ,也 就 是 说 ,Java 中 内 骨 HTML; 而 JSP 以 HTML 布局 为 主 ， 
需要 写 Java 代码 时 ,在 页 面 中 直接 插入 Java 代码 , 即 HTML 中 内 骨 Java。 

与 Servlet 相 比 ,JSP 最 大 的 优点 是 能 够 很 方便 地 实现 页 面 布局 ,显示 复杂 页 面 。 

与 JSP 相 比 ,Servlet 最 大 的 优点 在 于 后 台 处 理 , 在 业务 处 理 和 数据 运算 方面 更 稳健 。 
另外 , 像 动态 生成 验证 码 图 像 .显示 邮箱 的 利用 率 等 功能 ,通常 都 可 以 利用 Servlet 实现 。 

因此 ,在 实际 的 项 目 开 发 时 ,可 以 利用 JSP 技术 实现 页 面 表现 ,利用 Servlet 技术 完 
成 逻辑 处 理 , 将 二 者 有 机 地 结合 在 一 起 使 用 。 
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Servlet 的 生命 周期 主要 由 4 个 过 程 组 成 。 
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1 装载 和 创建 Seve 实例 
Servlet 容器 负责 将 Servlet 类 加 载 到 Java 虚拟 机 中 并 初始 化 。 加 载 和 实例 化 可 以 
发 生 在 Web 服务 程序 启动 时 ,也 可 以 在 客户 端 首次 提出 对 Servlet 服务 请 求 时 。 


2 初始 化 

当 容 器 装载 Servlet 时 , 它 会 运行 Servlet 的 init 〇 方法 。 在 Servlet 生命 周期 中 ,init() 方 
法 只 被 执行 一 次 。 为 了 提高 系统 性 能 ,可 以 在 init() 方 法 中 缓存 一 些 静态 的 数据 或 完成 
一 些 只 需要 执行 一 次 的 、 耗 时 的 操作 ,例如 初始 化 数据 库 连接 、 获 取 配 置信 息 等 。 在 初始 
化 不 成 功 时 ,Servlet 实例 将 抛 出 ServletException 异常 或 UnavailableException 异常 来 
通知 Web 容器 。ServletException 异常 用 于 指明 一 般 的 初始 化 失败 ,例如 没有 找到 初始 
化 参数 ;UnavailableException 异常 用 于 通知 容器 该 Servlet 实例 不 可 用 。 


3 执行 

初始 化 完毕 ,Servlet 就 可 以 通过 service() 等 方法 为 客户 提供 服务 请 求 。service() 方 
法 是 Servlet 的 核心 ,能 够 获得 与 服务 请 求 对 象 有 关 的 信息 ,对 请 求 进行 处 理 , 访 问 系统 
资源 ,然后 将 生成 的 响应 封装 在 响应 对 象 中 ,并 回 传 给 客户 端 。service() 在 执行 的 过 程 
中 可 能 会 调用 doPost() ,doGet() 或 程序 员 自 定义 的 方法 。 在 service() 方 法 执行 期 间 , 如 
果 发 生 错 误 ,Servlet 实例 将 抛 出 ServletException 异常 或 UnavailableException 异常 。 
当 发 生 UnavailableException 异常 时 ,客户 将 接收 到 HTTP 404( 请 求 的 资源 不 可 用 ) 响 
应 或 者 HTTP 503( 服 务 器 暂时 忙 ,不 能 处 理 请 求 ) 响 应 。 


4 服务 结束 

当 容 器 停止 且 印 载 Servlet 时 ,将 执行 destroy() 方 法 。 通 常情 况 下 ,不 需要 覆盖 
destroy() 方 法 ,但 是 当 需 要 完成 如 关闭 数据 库 连接 等 资源 回收 工作 时 ,可 以 覆盖 它 。 在 
destroy() 方 法 调用 之 后 ,该 Servlet 实例 将 会 被 容器 释放 并 被 Java 的 垃圾 收集 器 回收 。 
当 青 次 需要 请 求 该 Servlet 时 ,容器 会 创建 一 个 新 的 实例 。 
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Servlet 规范 中 规定 ,所 有 的 Servlet 类 必须 实现 javax. servlet. Servlet 接口 。Servlet 
规范 提供 了 该 接口 的 两 个 通用 实现 类 : javax. servlet. GenericServlet 和 javax. servlet. 
http. HttpServlet。 因 此 ,程序 员 在 编写 Servlet 时 , 既 可 以 直接 实现 Servlet 接口 ,也 可 以 
扩展 GenericServlet 或 HttpServlet。 由 于 目前 Servlet 容器 都 是 基于 HTTP 协议 的 ,所 
以 继承 HttpServlet 是 最 方便 、 最 快捷 的 开发 方式 。 

HttpServlet 类 中 包含 了 init() ,destroy() 和 service() 方 法 ,同时 增加 了 一 些 附加 的 
方法 ,这 些 方法 可 以 供 service() 自动 调用 。 其 中 最 重要 的 是 doGet() 方 法 和 doPost() 
遍 法 s 


1 dbGt( 方 法 
doGet() 方 法 用 于 处 理 HTTP 的 GET 请 求 。 当 客户 通过 HTML 表单 发 出 一 个 
HTTP GET 请 求 或 者 直接 请 求 一 个 URL 时 ,doGet() 方 法 被 自动 调用 。 与 GET 请 求 相 
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关 的 参数 添加 到 URL 的 后 面 ,并 与 这 个 请 求 一 起 发 送 。 当 不 会 修改 服务 器 端的 数据 时 ， 
应 该 使 用 doGet() 方 法 。 
doGet() 的 语法 如 下 : 
protected void doGet( 
HbpservletRequest request， // 指 定 HtpservletRequest 对 象 ,包含 客户 端 请 求 


HLtEServletResponse response 。 // 指 定 HeServletResponse 对 象 ,包含 sservlet 响 应 
)throws ServletException，ICException 


2 doPost( 方 法 

doPost() 方 法 用 于 处 理 HTTP 的 POST 请 求 。 当 客户 通过 HTML 表单 发 出 一 个 
HTTP POST 请 求 时 ,doPost() 方 法 被 自动 调用 。 与 POST 请 求 相关 的 参数 作为 一 个 单 
独 的 HTTP 请 求 从 客户 端 发 送 到 服务 器 。 当 需要 修改 服务 器 端的 数据 时 ,应 该 使 用 
doPost() 方 法 。 

doPost() 的 语法 如 下 : 

Protected void doPost ( 

HttpServletRequest request， // 指 定 HttpServletRequest 对 象 , 包 含 客 户 端 请 求 


HtpServletResponse respqnse 。 // 指 定 HttpBervletResponse 对 象 ,包含 servlet 响应 
)throws ServletExosption, ICExosption 
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下 面 通 过 一 个 简单 的 小 例子 说 明 如 何 编写 和 部 署 Servlet。 


1 编写 Sevet 
代码 3-4 给 出 的 servlet. LoginServlet 用 于 登录 时 的 身份 验证 。 


代码 3-4 LoginServlet. jsp 


Package servlet; 
import java.io.IOExcepticny 
import javax.servlet.ServletExosption; 
jimport javax.servlet.http.* ; 
Public class LoginServlet extends HttpServlet { 
Public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletExosption, ICExosption { 
// 由 于 本 程序 中 dcGet() 的 功能 和 doPost (0) 的 功能 一 致 ,将 直接 调用 doeost() 
GpPost (request., response); 
} 
Public void doPost (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletFxosption, IOExosption { 
// 设 置 request 字 符 编码 
Tequest.setCharacterEnooding ("utf— 8"); 
String path= request .getContextPath (); 
String basePathr request .getScheme ()+ "://"; 
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/获取 客户 请 求 参数 
String request .getParameter ("username") ; 
String password= request. .getParameter ("password") ; 
if (usemame.equals ("号 三 ") && password.equals("123")){ 
// 将 用 户 名 保存 在 sessicn 中 
HttpSession session= request..getSession(); 
Session.setRttribute ("usermame", usemame); 
// 重 定向 到 index.jsp 页 面 ,注意 : 由 于 index.jsp 位 于 网 站 根 目录 中 ,为 了 防止 
// 出 现 路 径 错误 ,最 好 使 用 绝对 路 径 
response.sendRedirect (basePatht "index.jsp"); 


response.sendRedirect (basePatht "login.jsp"); 


为 验证 上 述 程序 ,将 前 面 给 出 的 login. jsp 文件 的 action 值 修改 为 /servlet/ 
LoginServlet, 然 后 发 布 到 Web 服务 器 上 进行 查看 。 

基于 Web 的 服务 程序 在 与 客户 的 交互 过 程 中 完成 了 特定 的 系统 功能 。 为 了 实现 交 
互 过程 ,Servlet 中 必须 能 够 获取 客户 的 请 求 参数 ,能 够 完成 服务 响应 ,能 够 读 取 和 修改 
session, 能 够 实现 数据 流 输出 。 在 JSP 文件 中 ,可 以 通过 内 置 的 request、 response 和 
session 等 对 象 来 获取 这 些 信息 。 尽 管 在 Servlet 中 不 能 直接 使 用 JSP 提供 的 内 置 对 象 ， 
但 是 在 service()、doGet() 和 doPost() 等 方法 中 封装 了 类 型 为 HttpServletRequest 的 对 
象 request 和 类 型 为 HttpServletResponse 的 对 象 response。 利 用 request 对 象 可 以 获得 
与 客户 请 求 相关 的 信息 ,利用 response 对 象 可 以 完成 服务 响应 处 理 。 如 果 要 完成 与 
session 有 关 的 处 理 ,必须 获得 封装 在 request 或 response 中 的 HttpSession 的 实例 。 


2 部 署 Sevet 
在 编写 完 Servlet 之 后 ,必须 在 web. xml 中 对 它 进 行 正确 的 配置 之 后 才能 访问 。 代 
码 3-5 给 出 配置 了 LoginServlet 的 web. xml 。 


代码 3-5 在 web. xml 中 配置 Servlet 


< ?ml version= 叫 .0" encoding= "UTE- 8"?> 

< web- app versior= "2.5" 
xmlns= "http://java.sun.om/xml /ns/javaee" 
mlns:xsi= "http://www.w3.org/2001/XMLSchema— instance" 
xsi:schemaLocation= "http://java.sun.com/xml/ns/javaee 
http://java.sun.om/xml /ns/javaee/web- app 2 5.x3d"> 
<servlet>< !- 部 署 servlet.LoginServlet--> 

< description> Authenticate users< /descripticn> 
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< display- name> loginServlet< /display- neme> 
< servlet- name> LoginServlet< /servlet- neme> 
< servlet— class> servlet.LoginServlet< /servlet- class> 
< /servlet> 
< 二 为 servlet 作 UREL 映 射 一 > 
< servlet— mepping> 
< servlet- name> LoginServlet< /servlet- neme> 
< url- Pattern> /servlet/IoginServlet< /url- Pattern> 
< /servlet— mepping> 
< /web- spp> 


其 中 ,二 url-pattern 二 /servlet/LoginServlet 二 /url-pattern 二 标签 给 出 了 访问 该 
Servlet 所 要 用 到 的 URL ,也 就 是 为 什么 要 将 login. jsp 文件 的 action 值 修改 为 /servlet/ 
LoginServlet 的 原因 。 

MyEclipse 等 IDE 集成 开发 环境 能 够 自动 生成 Servlet 的 结构 框架 和 部 署 过 程 , 程 序 
员 在 开发 时 可 以 直接 采用 ,提高 编程 效率 。 


325 Seve 过 滤器 


1 什么 是 过 滤器 

Servlet 过 滤器 (Filter) 作 为 一 种 特殊 的 Servlet, 位 于 客户 端 和 Web 应 用 程序 之 间 。 
利用 Servlet 过 滤器 可 以 在 客户 请 求 到 达 Servlet 和 JSP 文件 之 前 ,或 在 服务 响应 到 达 客 
户 端 前 完成 一 些 附加 的 操作 。 多 个 过 滤器 形成 一 个 过 滤器 链 ,过 滤器 链 中 不 同 过 滤器 的 
先后 顺序 由 部 署 文件 web. xml 中 过 滤器 映射 二 filter-mapping 二 的 顺序 决定 。 图 3-2 演 
示 了 过 滤器 链 的 工作 机 制 。 


Filterl Filter2 


request 


客户 端 doFilter() Servlet/JSP 


response 


doFilter() 


图 3-2 ”Servlet 过 滤器 链 


利用 Servlet 过 滤器 可 以 完成 以 下 工作 。 

(1) 字符 编码 转换 : 利用 Servlet 过 滤器 解决 中 文 乱码 问题 。 

(2) 权限 验证 : 将 Web 服务 程序 的 身份 验证 功能 放 到 一 个 过 滤器 中 ,可 以 避免 在 每 
一 个 Servlet 类 和 JSP 文件 中 都 要 检查 用 户 是 否 登录 ,身份 是 否 合法 等 。 

(3) 日 志 记录 。 


2 过 滤器 的 编程 接口 


所 有 的 Servlet 过 滤器 类 都 必须 实现 javax. servlet. Filter 接口 。 这 个 接口 含有 过 滤 
器 类 必须 实现 的 3 个 方法 。 
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(1) public void init(FilterConfig config)。 这 是 过 滤器 的 初始 化 方法 ,Servlet 容器 
只 有 在 实例 化 过 滤器 时 才 会 调用 该 方法 一 次 。 该 方法 的 参数 是 一 个 FilterConfig 对 象 ， 
包含 与 Filter 相关 的 配置 信息 。 

(2) public void doFilter (ServletRequest request， ServletResponse response， 
FilterChain chain) 。 每 当 请 求 和 响应 经 过 过 滤器 链 时 ,容器 都 要 调用 一 次 该 方法 。 当 请 
求 访问 过 滤器 关联 的 URL 时 ,Servlet 容器 将 先 调用 过 滤器 的 doFilter 方法 ,FilterChain 
参数 用 于 访问 后 续 过 滤器 。 

(3) public void destroy() 。Servlet 容器 通过 调用 destroy() 方 法 删除 该 过 滤器 。 

Servlet 过 滤器 的 创建 步骤 如 下 。 

(1) 实现 javax. servlet. Filter 接口 的 Servlet 类 。 

(2) 实现 init 方法 , 读 取 过 滤器 的 初始 化 函数 。 

(3) 实现 doFilter 方法 ,完成 对 请 求 或 过 滤 的 响应 。 

(4) 调用 FilterChain 接口 对 象 的 doFilter 方法 ,向 后 续 的 过 滤器 传递 请 求 或 响应 。 

(5) 在 web. xml 中 配置 Filter。 


3 编写 过 滤器 
客户 端 利用 HTTP 协议 向 服务 器 发 送 的 数据 请 求 , 默 认 时 采用 的 是 ISO-8859-1 格 
式 编码 ,因此 利用 表单 或 者 URL 请 求 参数 向 Servlet 和 JSP 文件 传送 数据 时 ,其 中 的 中 
文 数据 如 果 不 加 处 理 ,在 接收 后 显示 时 会 出 现 乱码 。 为 解决 这 一 问题 ,可 以 编写 一 个 过 
滤器 将 Web 服务 器 接收 到 的 客户 请 求 转换 成 UTF-8 格式 。 代 码 3-6 给 出 了 一 个 将 客户 
请 求 转 换 成 指定 编码 格式 的 过 滤器 。 
代码 3-6 ”利用 过 滤器 解决 中 文 乱 码 (EncodeFilter. java) 


Package Filter; 

jimport java.io.IOExcepticny 

jimport javax.servlet. 关 ; 

public class EnoodeFilter implements Filter { 


Public void doFilter (ServletRequest request, 
ServletResponse response, FilterChain chain) 
throws ICExosption, ServletExosption { 

if (encoding !=null && !"™".equals (encoding)) { 
// 设 置 请 求 数据 的 编码 方式 
request .setCharacterEncoding (encoding) ; 
和 
Chain.doFilter (request, response); 
, 
Eublic void destroy() { 
//TODO mato- generated method sbub 
} 


piblic void init (FilterConfig filterConfig) throws ServletFxosption { 
/获取 Filter 的 初始 化 参数 的 值 = 
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4 过 滤器 的 配置 

过 滤器 与 普通 的 Servlet 一 样 , 也 是 在 web. xml 文件 中 配置 的 ;不 同 的 是 ,普通 的 
Servlet 要 想 发 挥 功 能 ,需要 客户 端 进 行 显 式 调用 ,而 过 滤器 只 需 在 web. xml 中 配置 好 就 
能 够 被 容器 自动 加 载 。 代 码 3-7 给 出 Filter. EncodeFilter 在 web. xml 中 的 配置 示例 。 


代码 3-7 在 web. xml 中 配置 过 滤器 


< ?ml version= "1.0" encoding= "UTF- 8"?> 
<web- app versicn= "2.5" 
xmlns= "http://java.sun.om/xml /ns/javaee" 
xmlns:xsi= "http://www.w3.0rg/2001/XMLSchema- instanoe" 
Xi:schemaLocation= "http://java.sun.oom/xml/ns/javaee 
http://java.sun.om/xml /ns/javaee/web- arp 2 5.x3d"> 
<filter> 
< 五 lter- name> EnoodeFilter< /filter- name> 
<filter- class> Filter.EnoodeFilter< /filter- class> 
< init- paren> 
< parem- neme> encoding< /parem- neme> 
< parem- value> UIF- 8< /parem- value> 
< /init- parer> 
</filter> 


<filter- mapping> < !-- 映 射 过 滤器 一 > 
< filter- name> EncodeFilter< /filter- name> 
< url- pattern> /* < /url- pattem> 
< /filter- mapping> 
< /web- app> 


其 中 ,标签 二 filtername 二 给 出 了 过 滤器 的 名 字 为 EncodeFilter; 二 filter-class 志 给 出 
了 过 滤器 EncodeFilter 对 应 的 Java 类 为 Filter. EncodeFilter. java; 一 initparam 二 定义 了 
该 过 滤器 包含 一 个 初始 化 参数 encoding , 值 为 UTF-8, 该 参数 由 Filter. EncodeFilter 实 
例 在 init() 方 法 中 利用 FilterConfig 对 象 接收 ;二 urL-pattern 二 指出 该 过 滤器 适用 于 所 有 
的 客户 请 求 。 
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331 JDBC 工 作 原 理 


Web 应 用 程序 离 不 开 数 据 库 的 支持 ,利用 数据 库 可 以 实现 Web 应 用 程序 数据 的 持 
久 化 存储 。 基 于 JSP 的 应 用 程序 在 连接 数据 库 时 可 以 通过 JDBC (Java Data Base 
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Connectivity,Java 数据 库 连 接 ) 技 术 来 完成 。JDBC 提供 了 连接 各 种 常用 数据 库 的 能 力 。 
JDBC 向 程序 员 提 供 了 一 组 独立 于 数据 库 的 API 接口 ,这 组 接口 提供 了 编写 标准 和 考虑 
了 不 同 应 用 程序 设计 的 标准 。 接 口 的 实现 放 在 数据 库 驱 动 程序 中 。 驱 动 程序 负责 将 标 
准 JDBC 调用 转变 为 特定 数据 库 所 需要 的 具体 调用 。 每 个 驱动 程序 针对 一 种 DBMS。 
3-3 给 出 了 JDBC 工作 原理 。 


JDBC API 
JDBC 驱 动 管理 器 | 
JDBC-ODBC JDBCmiddleware 
(gp | | ipscaia | [psc ( 驱动 ] 
Ut) 1 
| ODBC 连接! ek Ome 
| 的 数据 库 | | 数据 库 | 


图 3-3 JDBC 工作 原理 


常见 的 JDBC 连接 方式 分 为 以 下 4 种 类 型 。 

(1) JDBC-ODBC 桥 : 在 客户 端 安装 ODBC 驱动 程序 ,配置 ODBC 数据 源 , 然 后 利用 
ODBC 驱动 程序 提供 JDBC 访问 。 

(2) JDBC 本 地 API: 在 客户 端 安装 驱动 程序 ,通过 驱动 程序 将 客户 端 API 上 的 
JDBC 调用 转换 成 对 特定 DBMS 的 调用 。 

(3) JDBC-middleware 桥 : 该 方式 将 JDBC 访问 操作 直接 转换 成 与 DBMS 无 关 的 网 
络 协议 ,通过 该 协议 与 某 个 特定 的 中 间 件 服务 器 相 联系 , 再 由 该 服务 器 完成 与 DBMS 之 
间 的 数据 交换 。 该 方法 省 去 了 在 客户 端 安装 驱动 程序 的 麻烦 ,是 最 具 灵 活性 的 方式 。 

(4) 纯 Java JDBC 驱动 : 该 方式 利用 DBMS 提供 的 专用 驱动 程序 把 JDBC 调用 直接 转 
换 为 对 DBMS 的 操作 。 该 方式 在 4 种 方法 中 的 访问 效率 最 高 ,也 是 目前 最 流行 的 方式 。 

在 Web 应 用 程序 开发 时 ,程序 员 只 和 上 层 的 JDBC API 打交道 通常 ,利用 JDBC 
访问 数据 库 的 流程 分 为 如 下 几 个 步 又。 

(1) 加 载 JDBC 驱动 程序 ; 

(2) 建立 和 数据 库 之 间 的 连接 ; 

(3) 创建 表达 式 对 象 ; 

(4) 执行 数据 库 的 查询 添加、 修改 和 删除 等 操作 ; 

(5) 关闭 数据 库 连接 。 


332 ” JDBC 接口 


JDBC 定义 了 很 多 接口 和 类 .主要 包括 DriverManager、Connection、Statement 和 
ResultSet 等 。 
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1 驱动 程序 管理 器 DiverManager 

java. sql. DriverManager 类 用 于 管理 JDBC 驱动 程序 ,负责 跟踪 可 用 的 驱动 程序 ,并 
在 数据 库 和 驱动 程序 之 间 建 立 连 接 。 

DriverManager 类 中 最 常用 的 方法 为 getConnection(String url, String user，String 
password) 。 这 是 一 个 静态 方法 ,用 来 获得 数据 库 连接 。 方 法 的 三 个 参数 依次 为 要 连接 
数据 库 的 URL、 用 户 名 和 密码 。 该 方法 被 调用 时 , DriverManager 类 将 定位 指定 的 
Driver 类 ,并 利用 定位 到 的 Driver 类 建立 连接 。 连 接 成 功 时 ,将 返回 一 个 java. sql. 
Connection 对 象 实例 ;如 果 不 成 功 ,将 抛 出 SQLException 异常 。 

2 数据 库 连接 接口 Comecian 

java. sql. Connection 接口 负责 与 特定 数据 库 的 连接 。 通 过 该 连接 ,程序 员 可 以 执行 
SQL 语句 并 对 返回 的 结果 进行 处 理 ,也 可 以 利用 getMetaData( ) 方 法 获得 数据 库 的 元 数 
据 。Connection 接口 的 常用 方法 如 表 3-1 所 示 。 

表 3-1 Connection 接口 的 常用 方法 
方 ” 法 说 明 
createStatement() 创建 并 返回 一 个 Statement 实例 ,多 用 于 执行 不 含有 参数 的 SQL 语句 
prepareStatement() | 创建 并 返回 一 个 PreparedStatement 实例 ,多 用 于 执行 包含 参数 的 SQL 语句 
创建 并 返回 一 个 CallableStatement 实例 ,利用 该 方法 可 以 实现 对 数据 库 中 定 


prepareCall() 


义 的 存储 过 程 的 调用 
提交 当前 事务 对 数据 库 的 所 有 更 改 ,并 释放 Connection 实例 拥有 的 所 有 数据 
commit() 
库 加 锁 
rollback() 取消 当前 事务 中 的 所 有 更 改 ,并 释放 当前 Connection 实例 拥有 的 所 有 数据 库 
加 锁 。 该 方法 仅 适合 非 自动 提交 模式 
close() 关闭 数据 库 连 接 , 并 释放 Connection 实例 占用 的 数据 库 和 JDBC 资源 
isClosed() 查看 当前 的 Connection 实例 是 否 被 关闭 


设置 当前 Connection 实例 的 提交 模式 ,默认 为 true, 即 自动 将 更 改 同步 到 数据 
setAutoCommit() 库 中 。 如 果 设 为 false, 需 要 通过 执行 commit() 或 rollback() 方 法 手动 将 更 改 


同步 到 数据 库 中 
getAutoCommit() 查看 当前 的 Connection 实例 是 否 处 于 自动 提交 模式 
setSavepoint() 非 自动 提交 模式 下 ,在 当前 事务 中 创建 并 返回 一 个 Savepoint 实例 


releaseSavepoint() ”| 从 当前 事务 中 删除 指定 的 Savepoint 实例 


设置 当前 Connection 实例 的 读 取 模式 ,默认 为 非 只 读 模 式 。 不 能 在 事务 当中 
执行 该 操作 ,否则 将 抛 出 异常 


isReadOnly() 查看 当前 的 Connection 实例 是 否 为 只 读 模式 


setReadOnly() 


3 执行 SQL 语句 接口 Satement 
java. sql. Statement 接口 用 来 执行 静态 的 SQL 语句 ,并 返回 执行 结果 。Statement 
接口 的 常用 方法 如 表 3-2 所 示 。 
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表 3-2 Statement 接口 的 常用 方法 


方 法 


说 明 


executeQuery(String sql) 


执行 SELECT 语句 ,查询 结果 存储 在 一 个 ResultSet 实例 中 


executeUpdate(String sql) 


执行 指 INSERT、UPDATE 或 DELETE 语句 ,返回 结果 为 一 个 int 型 数 
值 ,用 于 说 明 数 据 库 中 受 影响 的 记录 的 条 数 


addBatch(String sql) 


将 INSERT 或 UPDATE 语句 添加 到 Batch 中 。 如 果 JDBC 驱动 程序 不 
支持 批量 处 理 , 将 抛 出 异常 


clearBatch() 


清除 Batch 中 的 所 有 SQL 语句 ,如 果 驱 动 程序 不 支持 批量 处 理 , 将 抛 出 
异常 


executeBatch() 


执行 Batch 中 的 所 有 SQL 语句 , 当 全 部 执行 成 功 时 ,返回 一 个 更 新 计数 
数组 ,数组 元 素 表示 对 应 的 SQL 语句 执行 情况 ,其 值 可 以 为 : 四 大 于 或 
等 于 零 的 数 ,表示 SQL 语句 成 功 执行 ,为 影响 数据 库 中 行 数 的 更 新 计 
数 ; @ 一 2, 表 示 SQL 语句 成 功 执行 ,但 没有 得 到 受 影响 的 行 数 ; 四 一 3， 
表示 SQL 语句 执行 失败 。 当 驱动 程序 不 支持 批量 ,或 者 Batch 中 的 某 
一 个 SQL 语句 未 能 成 功 执行 时 ,将 抛 出 异常 


close() 


关闭 Statement 实例 ,释放 Statement 实例 占用 的 数据 库 和 JDBC 资源 


4 执行 动态 SQL 语 句 接口 PeparedStaterrenrt 
java. sql. PreparedStatement 接口 是 对 Statement 接口 的 扩展 ,用 来 执行 包含 参数 的 
SQL 语句 。PreparedStatement 接口 提供 了 一 系列 setXxx 方法 ,用 于 对 SQL 语句 中 的 


参数 赋值 。 


代码 3-8 演示 了 如 何 使 用 PreparedStatement 接口 执行 动态 的 SQL 语句 。 
代码 3-8 ”PreparedStatement 接口 执行 动态 的 SQL 语句 


String now= new java.util .Date(); 

java.text.SimpleDateFommat sd 全 

new java.text.SinmpleDateFonmat ("YYYY- MM dd HH:mm:ss") 7 

String sql= "insert into notes (title, omntent,pubTime) values (?,3,3)"; 
PreparedStatement pe= conn.PrepareStatement (sq1); 

ps.setstring(1, "请 教 一 个 JIEC 的 问题 "); 

Ps.setString(2, "如 何 利用 PreparedStatement 执行 动态 SQL?"); 
Pe.setTimeStamp (3, sdf.parse (now)); 

int cnt= ps .ewecuteDpdate () 7 


需要 注意 的 是 ,在 对 SQL 语句 中 的 参数 赋值 时 ,必须 使 用 与 输入 参数 的 类 型 相 兼容 


的 setXxx() 方 法 。 


5 执行 存储 过 程 接口 CalableSiatermert 

在 进行 Web 开发 时 ,通常 会 将 一 些 常用 的 或 很 复杂 的 数据 库 操 作 定义 为 存储 过 程 。 利 
用 java. sql. CallableStatement 接口 可 以 执行 数据 库 中 定义 的 存储 过 程 。CallableStatement 
是 对 PreparedStatement 接口 的 扩展 ,可 以 通过 Connection 的 prepareCall( ) 方 法 获取 
CallableStatement 对 象 ,形式 如 下 : 


con.prepareCall ("{call 存储 过 程 名 (2,23)1m7 
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其 中 ,con 为 Connection 对 象 ,问号 为 存储 过 程 的 参数 ,其 值 可 以 利用 setXxx() 方 法 
进行 设置 。 对 于 具有 输出 参数 的 存储 过 程 ,需要 利用 registerOutParameter() 方 法 将 结 
果 参 数 注册 为 OUT 类 型 ,在 存储 过 程 执行 后 可 以 通过 getXxx 方法 检索 。 

假设 SQL Server 数据 库 中 有 一 个 用 于 计算 两 个 数 乘 积 的 存储 过 程 mathtutor。 

CREATE, PROCEDURE dbo-mathtutor 

@ml srallint, 

eme smallint, 
@ result smallint OUTPUT 


ns 
SET@result=@m * @n2 


代码 3-9 演示 了 如 何 利用 CallableStatement 调用 mathtutor。 
代码 3-9 调用 存储 过 程 (mathtutor. jsp) 


< $@ Page language= "java" pageEncoding= "UTF- 8"%> 
< $@ page import= "java.sql.* " %> 
<htm> 
<head> 
<title> 测 试 访问 数据 库存 储 过 程 < /title> 
< /head> 
<body> 
<% 
String DRIVER= "net .30uroeforge.jtds.jdbc.Driver"; 
String URL = "jdbc:jtds:sqlserver://127.0.0.1:1433/notes"; 
String DENAME= "sa"; 


String DBERSS= "123"; 
Class. forName (DRIVER) // 加 载 unec 驱 动 
try{ 
// 连 接 指定 的 数据 库 
Connecticn conn= DriverManager.getConnecticn (URL,DENRME,DEERSS) 
CallableStatement proc= null; 
// 惟 备 调用 doo.mathtutor 存储 过 程 
Proo= oorn.prepareCall ("{ call dbo.mathtutor (?,?,?) }"); 
Proc.setInt (1,20); /为 存储 过 程 第 1 个 参数 传 值 20 
Froc.setInt (2,30); /为 存储 过 程 第 2 个 参数 传 值 30 


// 存 储 过程 第 3 个 参数 注册 为 cm 类 型 
Proc.registerOutParameter (3,TYPes.INTESER) ; 


Froc.execute (); /执行 存储 过 程 
int result— Proc.getInt (3); // 获 得 存储 过 程 的 返回 值 
out.printin("20* 30= "+ result); /输出 存储 过 程 的 返回 结果 
conn.close(); /人 关闭 数 据 库 连接 

} catch (SQLExcepticn exception) { 

exception .printstackrrace (); 
} 
%> 
< /body> 
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6 访问 结果 集 接 口 ResutSet 

java. sql. ResultSet 接口 用 于 访问 检索 结果 集 ,其 形式 可 以 看 做 一 个 内 存 表 或 是 数据 
库 中 的 游标 , 表 的 列 名 和 类 型 对 应 执行 查询 数据 库 的 语句 目标 列 的 列 名 和 类 型 。 

ResultSet 接口 提供 了 一 组 方法 : first() \last() .previous() 和 next() ,用 于 移动 指向 
数据 行 的 指针 。 最 初 ,指针 指向 首 记 录 的 前 方 ,利用 next() 方 法 可 以 将 指针 移动 到 下 一 
条 记录 ; 当 移 动 到 尾 记 录 末 尾 时 ,将 返回 false。 默 认 时 ,ResultSet 对 象 不 可 以 更 新 ,只 能 
通过 next() 方 法 遍历 结果 集 。 如 果 需 要 ,可 以 生成 可 滚动 和 可 更 新 的 ResultSet 对 象 。 

ResultSet 接口 提供 了 一 组 从 当前 行 检索 不 同类 型 列 值 的 getXxx() 方 法 ,每 个 方法 
都 有 两 个 重 载 方法 ,可 以 通过 列 的 索引 编号 或 列 的 名 称 检索 。 
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要 想 使 用 JDBC 访问 数据 库 , 首 先 必须 安装 JDBC 驱动 程序 ,大 多 数 DBMS 都 有 自 
己 专 用 的 驱动 程序 。 假 设 数据 库 的 名 称 为 notes, 下面 介绍 三 种 常用 的 数据 库 服务 器 配 
置 驱动 程序 的 方法 。 


1 访问 MB SGL Sener 数据 库 

MS SQL Server 版 本 比较 多 , SQL Server 2000 版 本 在 利用 JDBC 访问 时 必须 安装 
SP4 补丁 ,比较 麻烦 。 建 议 初学 者 安装 SQL Server 2005 或 更 高 版 本 ,并 且 下 载 和 安装 
JDBC 驱动 。JSP 应 用 程序 的 驱动 程序 通常 放 到 Web 应 用 目录 的 /WEB-INFVlib 下 ,该 
驱动 程序 只 能 供 本 Web 应 用 程序 使 用 。 如 果 要 让 Web 服务 器 上 的 所 有 Web 应 用 共享 
驱动 程序 ,可 以 将 其 复制 到 Tomcat 安装 目录 的 /lib/ 中 (以 Tomcat 服务 器 为 例 ) 。 

(1) 微软 专用 驱动 的 连接 字符 串 格式 

最 新 版 本 的 SQL Server 驱动 程序 的 名 称 为 sqljdbc4. jar。 这 里 以 SQL Server 2005 
Express 版 为 例 , 说 明 如 何 配置 JDBC 驱动 程序 名 称 和 连接 字符 串 。 

String DRIVER= "com.microsoft.sqlserver.jdbc.SQLServerDriver"7 

String URL= "jdbc:sqlserver://127.0.0.]\\sqlexpress:1433;DataPassNeme= notes"; 

String DENAME= "sa"; 

String DBEASS= "imonday"; 

Class.forName (TRIVER); 

Connecticn conn= DriverManager .getConnection (URL, DENAME, [BPASS) ; 

(2) JTDS 驱动 的 连接 字符 串 格式 

JTDS 是 为 SQL Server 和 Sybase 提供 的 第 三 方 JDBC 驱动 ,与 Microsoft 专用 驱动 
不 同 ,JTDS 在 连接 不 同 版 本 的 SQL Server 时 ,其 连接 字符 串 完全 一 致 ,并 且 效 率 更 高 。 
jtds. jar 可 以 从 http://jtds. sourceforge. net/ 免 费 下 载 。 

String TRIVER= "net.sourceforge.jtds.jdbc.Drivery 

String URI= "jdbc:jtds:sqlserver://127.0.0.1:1433/notes"; 

String DENAME= "sa"; 

String DBPASS= "123"; 

Class.forName (DRIVER) ; 
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Comnection conn= DriverManager .gstConnection (URL, DENAME, DBPASS) ; 


2 访问 Qade 数 据 库 

Oracle 作为 关系 数据 库 中 的 “大 哥 大 ”, 在 Web 应 用 开发 中 一 直 扮 演 着 重要 角色 。 
Oracle 的 JDBC 驱动 的 最 新 版 本 为 ojdbc14. jar。 

String DRIVER= "oracle.jdbc.driver.OracleDriver"; 

String URIF "jdbc:oracle:thin:@ 127.0.0.1:1501:0RcL"; 

String DENAME= " notes "; 

String DBERSS= "123"; 

Class.forName (DRIVER) 

Connecticn conn= DriverManager .getConnection (URL, DENAME,, DBPASS) ; 


3 访问 WSQ 数据 库 

MySQL 是 一 种 开放 源 代 码 的 关系 型 数据 库 管理 系统 ,由 于 其 强大 的 功能 和 小 巧 的 
身材 而 深 受 Java 程序 员 喜 爱 , 下 载 地 址 为 http://www. mysql. com/。MySQL JDBC 驱 
动 程序 的 名 称 为 mysql-connector-java-x. x. x-bin. jar, 其 中 x. x. x 为 版 本 号 ,截至 作者 编 
写本 书 时 ,最 新 的 版 本 号 为 5. 1. 20。 

String DRIVER= "ccm.mysdl .jdbc.Driver"; 

String URIF "jdbc:mysql ://127.0.0.1:3306 notes "; 

String DENAME= "root"; 


Connecticn conn= DriverManager .getConnection (URL, DENAME, DBPASS) ; 
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1 什么 是 数据 库 连 接 池 

利用 JDBC 访问 数据 库 中 的 数据 ,如 果 每 一 次 访问 都 要 重新 建立 数据 库 连 接 , 将 延长 
数据 库 访问 时 间 ,并 严重 影响 系统 性 能 。 另 外 ,如 果 对 数据 库 的 连接 数量 不 加 控制 ,可 能 
会 出 现 超过 数据 库 处 理 能 力 的 连接 数量 和 处 理 请 求 。 当 频繁 发 生 这 种 操作 时 ,系统 的 性 
能 将 下 降 ,甚至 月 溃 。 

数据 库 连 接 池 正 是 为 解决 上 述 问题 而 提出 的 。 所 谓 数 据 库 连 接 池 , 就 是 当 系统 启动 
时 ,一 次 性 建立 起 一 定数 量 的 数据 库 连接 ,一 旦 应 用 程序 需要 连接 数据 库 时 ,就 从 连接 池 
中 取出 一 个 连接 分 配给 应 用 程序 ;访问 数据 库 操作 完成 后 ,分 配 的 连接 重新 交还 给 连接 
池 。 通 过 这 种 方式 ,允许 应 用 程序 重复 使 用 一 个 现 有 的 数据 库 连 接 , 避 免 了 每 次 读 写 数 
据 库 时 都 要 装载 驱动 .建立 连接 的 过 程 , 对 于 读 写 数 据 库 操 作 比 较 频繁 的 系统 ,可 以 大 大 
提高 整体 性 能 。 

因此 ,使 用 连接 池 具 有 下 列 优点 。 

(1) 采用 数据 库 连 接 池 ,避免 了 每 次 数据 库 访问 时 都 要 重新 建立 数据 库 连 接 , 重 新 进 
行 身份 认证 的 过 程 , 从 而 节省 了 时 间 ,提高 了 系统 性 能 。 

(2) 解决 了 数据 库 对 连接 数量 限制 的 问题 。 


50 和 Web 应 用 程序 开发 技术 一 -JSP+Struts 2 


(3) 允许 应 用 程序 重复 使 用 同一 数据 库 连接 。 

当然 ,连接 池 也 有 一 定 的 缺陷 。 由 于 服务 器 启动 时 就 会 创建 一 定数 量 的 数据 库 连 
接 , 当 请 求 数目 远 远 少 于 连接 数目 时 ,将 导致 系统 中 存在 很 多 空 连接 ,它们 会 消耗 一 定 的 
系统 资源 。 在 配置 连接 池 时 ,可 以 通过 设置 maxIdle 参数 来 减少 由 于 空 连接 而 造成 的 系 
统 资源 浪费 。 一 旦 系统 中 的 空 连接 数量 超过 maxIdle 时 ,系统 将 自动 释放 超过 部 分 的 
连接 。 

2 Taonrcd 连接 池 的 配置 与 访问 

现在 主流 的 Web 服务 器 都 提供 了 数据 库 连 接管 理 服务 。 下 面 以 Tomcat 服务 器 为 
例 , 介 绍 数据 库 连 接 池 的 设置 和 使 用 方法 。 

(1) 正确 安装 JDBC 驱动 程序 。 将 JDBC 驱动 程序 复制 到 Web 应 用 目录 的 /WEB- 
INFVlib 或 Tomcat 安装 目录 的 /lib/ 中 。 

(2) 配置 连接 池 。 在 配置 Tomcat 连接 池 时 使 用 了 Java 提供 的 JNDI 技术 。 所 谓 
JNDI(Java Naming and Directory Interface,Java 命名 和 目录 接口 ) ,是 一 组 在 Java 应 用 
中 访问 命名 和 目录 服务 的 API。 利 用 JNDI, 应 用 程序 很 容易 根据 连接 池 名 称 查找 到 连 
接 池 对 象 。 

Tomcat 连接 池 的 配置 有 两 种 方法 。 一 种 方法 是 将 配置 文件 保存 在 Web 应 用 目录 
的 /META-INF/ 中 ; 另 一 种 方法 是 将 配置 信息 放 在 Tomcat 安装 目录 /conf/context. xml 
文件 中 。 

下 面 以 MySQL 数据 库 为 例 , 介 绍 采用 第 一 种 方法 配置 连接 池 的 过 程 。 在 Web 应 用 
目录 的 /META-INF/ 中 建立 context. xml 文件 ,如 代码 3-10 所 示 。 


代码 3-10 ”连接 池 配 置 文件 context. xml 


< ?ml version= "1 .0" encoding= "UIF- 8"?> 


type= "javax.sq] .DataSouroe" 
maxActive= "100" 
maxIdle= "30" 
maxWait= "10000" 
Usemame= "root" 
password= "123" 
driverClassName= "om.mysq] .jdbc.Driver™" 
url= "jdbc:mysql://127.0.0.1:3306/notes" 
心 
< /Context> 


其 中 ,每 个 字段 的 属性 的 含义 如 下 。 
@ name: JNDI 名 称 , 也 是 数据 库 连 接 池 的 名 称 , 这 里 取 值 为 jdbc/notes。 在 应 用 程 
序 中 可 以 通过 jdbc/notes 申请 数据 库 连接 。 
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@ auth: 数据 源 的 管理 者 ,有 两 个 可 选 值 Container 和 Application。Container 表示 
由 容器 来 创建 和 管理 数据 源 ,Application 表示 由 Web 应 用 来 创建 和 管理 数据 源 。 

@ type: 数据 源 的 类 型 。 

@ username: 连接 数据 库 的 用 户 名 。 

@ password: 连接 数据 库 的 密码 。 

maxActive: 连接 池 中 处 于 活动 状态 的 数据 库 连 接 的 最 大 数目 。 当 取 值 为 0 时 ， 


表示 不 受 限制 。 
@ maxIdle: 连接 池 中 处 于 空闲 状态 的 数据 库 连接 的 最 大 数目 。 当 取 值 为 0 时 , 表 
示 不 受 限制 。 


maxWait: 最 长 建立 连接 等 待 时 间 , 单 位 为 ms。 如 果 超 过 该 时 间 , 将 发 生 异 常 ; 当 
取 值 为 一 1 时 ,表示 无 限制 。 

@@ driverClassName: 连接 数据 库 的 JDBC 驱动 程序 。 

四 url: 连接 数据 库 的 路 径 。 

除了 上 述 方法 外 ,还 可 以 在 Tomcat 安装 目录 /conf/ 的 context. xml 文件 中 配置 连接 
池 。 方 法 是 将 代码 3-10 中 二 Resource 二 二 /Resource 二 标签 及 其 下 面 的 所 有 内 容 复制 到 
context. xml 的 二 context 二 一 /context 二 标签 下 。 

(3) 在 配置 完 数据 库 连 接 池 之 后 ,就 可 以 在 JSP JavaBean 和 Servlet 中 利用 JNDI 访 
问 数据 源 了 。 代 码 3-11 演示 了 在 JSP 中 使 用 连接 池 的 方法 。 

代码 3-11 测试 数据 库 连接 池 (dspool. jsp) 


< $@ page language= "java" pageEnooding= "UTIF- 8"%> 
< $@ page import= "java.sql.* " %> 
< $@ page import= "javax.sql .DataSouroe" %> 
< $@ page import= "javax.naming. * " $> 
<html> 

<head> 

<title> 测 试 数据 库 连 接 池 < /title> 
< /head> 


Connecticn conn= null; 
try{ 
Context io= new InitialContbesxt (); 
/查找 oNDI, 获 得 ocntext 中 配置 的 连接 池 对 象 jdbc/notes 
DataScurce ds= (DataScurce)ic.lcckzp (java:omp/erv/jcbc/notes"); 
// 从 连接 池 中 获得 数据 库 连 接 
conn= ds.getConnecticn (); 
String sql= "select userName,password fram users"; 
Statement stmt= conn.createStatement (); ”// 创 建 statement 
ResultSet rs= stmt.executeQuery(sql);  // 执 行 select 查询 
while(rs.next ()){ 
out.printin(" 用 户 名 :"+ rs.getString ("userName")); 
out.println ("gnbsp; gnbsp; snbsp;"); 
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cut.println( 喧 码 : "+ rs.getString(password"))7 
out.println ("<br/> "); 
} 
rs.close(); 
Stmt.close(); 
commn.close(); // 注 意 ,此 处 是 将 连接 返还 给 连接 池 
} catch (SQLExosption excepticn) { 


在 代码 3-11 中 ,通过 JNDI 得 到 配置 好 的 数据 源 DataSource 对 象 ds, 然 后 利用 ds. 
getConnection() 从 连接 池 中 申请 连接 ,最 后 利用 conn. close() 将 连接 返还 给 连接 池 。 


34 JSP MC 编程 


341 MWC 设计 思想 


MVC(Model-View-Controller) 是 模型 (Model) 、 视 图 (View) 和 控制 (Controller) 的 
缩写 ,是 在 系统 开发 中 最 为 流行 的 设计 模式 之 一 。 利 用 MVC 模式 ,可 以 实现 Web 应 用 
程序 的 职能 分 工 。 图 3-4 给 出 了 MVC 模式 中 各 个 部 件 之 间 的 关系 。 


模型 
封装 应 用 程序 的 状态 
呈现 业务 处 理 刘 辑 
响应 视图 对 状态 的 查询 
将 状态 变化 通知 视图 状 
变 
控制 器 
向 本 二 家 各 新 , 定义 应 用 程序 的 行为 
发 送 用 户 输入 给 控制 器 ht 
允许 控制 器 选择 视图 应 


图 3-4 MVC 模式 中 模型 .视图 和 控制 器 的 关系 


模型 是 MVC 模式 的 核心 , 它 封装 了 系统 的 核心 数据 ,业务 处 理 逻 辑 和 功能 的 计算 关 
系 , 独 立 于 具体 的 界面 表达 和 1/O 操作 。 例 如 ,Excel 中 的 一 组 数据 既 可 以 显示 为 表格 ， 
也 可 以 显示 为 饼 图 或 柱状 图 等 。 正 是 由 于 被 模型 封装 的 数据 独立 于 其 显示 方式 ,所 以 应 
用 于 模型 的 代码 只 需 写 一 次 就 可 以 被 多 个 视图 重用 ,减少 了 代码 的 重复 性 。 
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视图 代表 用 户 交互 界面 。 对 于 Web 应 用 程序 来 说 ,视图 就 是 由 HTML、 Adobe 
Flash、XHTML、XML/XSL 和 WML 等 元 素 构 成 的 界面 。 一 个 规模 比较 大 的 应 用 系统 ， 
其 界面 的 处 理 也 变 得 具有 挑战 性 。 同 一 个 数据 模型 可 能 有 很 多 不 同 的 视图 ,利用 MVC 
设计 模式 对 于 视图 的 处 理 仅 限于 视图 上 数据 的 采集 、 处 理 和 接收 用 户 的 请 求 ,不 包括 对 
这 些 数据 和 请 求 的 业务 处 理 。 业 务 的 处 理 是 由 模型 完成 的 。 例 如 ,在 基于 MVC 架构 实 
现 的 留言 板 程序 中 ,显示 留言 的 视图 只 接受 来 自 模 型 的 数据 并 显示 给 用 户 , 而 创建 留言 
的 视图 只 负责 将 用 户 界 面 的 输入 数据 和 请 求 传递 给 控制 和 模型 。 

控制 器 定义 了 视图 对 用 户 输 入 的 响应 方式 , 它 不 负责 任何 数据 处 理 。 当 控制 器 接收 
到 一 个 用 户 请 求 时 , 它 只 是 负责 决定 调用 哪个 模型 去 处 理 该 请 求 。 因 此 ,控制 器 是 协调 
模型 和 视图 工作 的 部 件 。 

MVC 模式 使 得 模型 和 视图 相互 独立 ,可 以 把 一 个 模型 独立 地 移植 到 新 的 平台 工作 ， 
需要 做 的 只 是 在 新 平台 上 对 视图 和 控制 器 进行 新 的 修改 。MVC 模式 使 得 模型 中 的 数据 
发 生变 化 时 ,所 有 依赖 于 该 数据 的 视图 都 会 反映 出 这 些 变 化 ,从 而 使 所 有 关联 的 视图 和 
控制 器 做 到 行为 同步 。 利 用 MVC 模式 ,可 以 将 应 用 程序 分 割 成 若干 逻辑 部 件 , 每 个 部 件 
交 由 不 同 的 开发 人 员 去 完成 ,这 有 助 于 实现 团队 协作 开发 。 

在 JSP 开发 过 程 中 ,基于 MVC 模式 的 Web 开发 框架 包括 Struts 2、Spring、JSF 和 
Tapestry 等 。 
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在 早期 的 JSP 应 用 程序 开发 中 ,模型 的 角色 通常 由 JSP 页 面 或 HTML 页 面 来 充当 ， 
视图 的 角色 由 JavaBean 来 充当 ,控制 器 的 角色 可 以 利用 Servlet 来 实现 。 图 3-5 给 出 了 
基于 Servlet 的 MVC 模式 的 架构 。 


Web 服 务 器 


请 求 | Servlet 
(Controller) 


浏览 器 aa em 


响应 | | jsp ~ JavaBeans 企业 级 服务 器 / 
数据 源 


(View) TT (Model) 


3-5 ”基于 Servlet 的 MVC 模式 的 架构 


Servlet 负责 接收 用 户 的 请 求 , 并 将 请 求 分 发 给 响应 的 视图 来 产生 响应 。Servlet 控 
制 器 还 根据 JSP 视图 的 需求 生成 JavaBean 的 实例 并 输出 给 JSP 页 面 。JSP 视图 可 以 通 
过 直接 调用 JavaBean 实例 的 方法 或 使 用 二 jsp: getProperty 二 动作 获得 JavaBean 中 的 
数据 。 

接 下 来 通过 一 个 实例 演示 如 何 利 用 JSP 十 Servlet 十 JavaBean 实现 MVC 模式 。 为 了 
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方便 读者 理解 ,图 3-6 给 出 了 本 实例 在 myEclipse 集成 开发 环境 中 的 目录 结构 。 请 大 家 
认真 查看 JSP 文件 和 Servlet 文件 所 在 的 目录 ,体会 为 什么 LoginServlet 类 重 定向 页 面 
的 URL 路径 要 写成 /success. jsp 和 /failure. jsp 的 形式 ,而 failure. jsp 页 面 中 超级 链接 的 
URL 路 径 要 写成 /Login/login. jsp 的 形式 。 能 否 采取 其 他 形式 书写 各 个 页 面 的 路 径 呢 ? 


Ein Hod 
Authen jave 


模型 


图 3-6 基于 Servlet 的 MVC 实例 的 目录 结构 
该 例子 中 包括 两 个 Bean 类 : User 类 和 Authen 类 。User 对 象 负责 保存 登录 用 户 的 
信息 ,Authen 对 象 负责 实现 对 登录 用 户 的 信息 进行 验证 的 业务 逻辑 。 代 码 3-12 给 出 了 
User 类 和 Authen 类 的 代码 片段 。 
代码 3-12 ”模型 User. java 和 Authen. java 


/# User.java * / 
Package Login.Model; 
public class User { 
private String usernamey // 用 户 名 


Private String password; /密码 


// 省 略 了 usemame 和 password 的 getter 和 setter 方 法 
} 


/# Athen.jeva * / 
Package Iogin.Model; 
Public class Authen { 
Private User user; 
public Authen (User user) { 
this.user= user; 
} 


// 省 略 了 user 的 getter 和 setter 方 法 
piblic boolean validate({ 
String user.getUsername (); 
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String Password- user.getPassword ()7 
// 简 化 了 业务 处 理 逻 辑 , 直 接 判 断 了 用 户 名 和 密码 
/真正 的 系统 中 ,需要 查询 数据 库 进行 验证 
if ("zhangsan".equals (nsername) &&"123".equals (password)) 
retum true; 
else 
retum false; 


} 


视图 部 分 由 三 个 JSP 页面 组 成 : login. jsp、success. jsp 和 failure. jsp。login. jsp 负 
责 显 示 一 个 登录 表单 ;Success. jsp 负责 在 登录 成 功 后 向 用 户 显示 欢迎 信息 ,这 里 直接 利 
用 一 jsp:userBean 二 动作 取出 了 保存 在 session 中 的 user 对 象 ;failure. jsp 在 登录 信息 未 
通过 验证 后 显示 错误 提示 。 代 码 3-13 给 出 了 视图 部 分 的 代码 。 


代码 3-13 ”视图 页 面 login. jsp、success. jsp 和 failure. jsp 


<!-- login.jsp——> 
< $8 page language= "java" pageEnooding= "UTF- 8"%> 
<html> 
<head> 
<title> 登 录 < /title> 
< /head> 
<body> 
<h2> 请 您 登录 < /h2> 
< form name= "fomml" action= "servlet/IoginServlet" method= "post"> 
用 户 名 : < input type= "text" name= "usermame"> <br> 
口令 : < input type= "password" name= "password"> <br> 
<input type= "aitmit" value "得 交心 
<input type= "reset" value= " 重 置 "> 
< /fom> 
< /body> 
< /html> 


< !-- success.jsp-—> 
< $@ page language= "java" pageEnooding= "UTF- 8"%> 
< $@ page import= "Togin.Model.User" %> 
<html> 
<head> 
<title> 登 录 成 功 < /title> 
< /head> 
<body> 
< jsp:useBean idF "user" class= "Togin.Model .User" scoper= "session"/> 
<h2> 
< jsp:getProperty property= "username" name= "user"/> 您 好 ,欢迎 登录 系统 ! 
< 2> 
< /body> 
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< /himl> 


< 上- failure.jsp--> 
< $@ page language= "java" pageEnooding= "UTF- 8"%> 
<html> 
<head> 
<title> 登 录 失 败 < /title> 
< /head> 
<body> 
<h2> 用 户 名 或 者 口令 不 正确 ,请 
<a href= "/Iogin/login.jsp"> 重 新 登录 !< /a>< /h2> 
< /body> 
</html> 


LoginServlet 类 充当 了 控制 器 , 它 接 收 Login. jsp 页 面 发 送 来 的 用 户 请 求 ,实例 化 
User 对 象 保存 用 户 登 录 信息 ,实例 化 Authen 类 对 用 户 登 录 信 息 进行 验证 ,然后 根据 验 
证 的 结果 选择 对 应 的 视图 响应 给 用 户 。 代 码 3-14 给 出 了 LoginServlet 类 的 代码 。 


代码 3-14 ”视图 页 面 login. jsp ,success. jsp 和 failure. jsp 


Package Login.Servlet; 

import java.io.IOEwosption; 

jimport javax.servlet.RequestDispatcher; 

jimport javax.servlet.ServletExosption; 

jimport javax.servlet.http.* ; 

jimport Login.Model.* ; 

Public class LoginServlet extends HttpServlet { 

Public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletExosption, ICExosption { 
GoPost (request, response); 


Public void doPost (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletExosption, ICExosption { 
String Usernamer= request .getParameter ("usemame"); 
String password= request .getParameter ("password") ; 
User user= new User (); // 创 建 模型 对 象 
User.setUsername (usermame); 


Authen authen= new Authen (user); 

String forward; // 保 存 要 转向 的 视图 文件 

// 如 果 登 录 成 功 ,把 用 户 名 写 人 sessicn, 并 且 转 向 success.jsp, 

// 否 则 转向 failure.jsp 

if (authen.validate()){ // 调 用 authen 对象 的 方法 进行 验证 
HttpSession session= (HttpSession) request .getSession (true); 
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Sessican-setattribute ("user", user); // 把 用 户 保存 到 =essim 中 

forward= "/sucoess.jsp"; // 指 定 目标 转向 文件 为 sucoess.jsp 
} 
else 

forward "/failure.jsp"; // 指 定 目标 转向 文件 为 failure.jsp 
RequestDispat dher dispatcher= reqnest.getRegqnestDispatdher (forward) ; 
ispatcher .forward (reqpest, response) ; // 完 成 跳 转 


. 


代码 3-15 给 出 了 web. xml 中 LoginServlet 的 配置 。 


代码 3-15 web. xml 


< ?ml version= "1.0" encoding= "UIF- 8"?> 
<web- app versicn= "2.5" 
xmlns= "http://java.sun.om/xml/ns/javaee" 
xmlns:xsi= "http://www.w3.org/2001/XMLSchema- instance" 
x3i:schemalocation= "http://java.sun.cam/xml/ns/javaee 
http://java.sun.com/xml /ns/javaee/web- app 2 5.x3d"> 
< servlet> 
< description> Authenticate users< /description> 
< display- name> loginServlet< /display- name> 
< servlet— name> LoginServlet< /servlet- name> 
< servlet— class> Login.Servlet .LoginServlet< /servlet- class> 
< /servlet> 


< servlet- mapping> 
< servlet- name> LoginServlet< /servlet- name> 
<url- pattern> /servlet/LoginServlet< /url- pattem> 
< /servlet- mapping> 
<welcome file list> 
<wElcome filey login.jsp< /welccme file>< !-- 欢 迎 页 面 --> 
< /welome- file- list> 
< /web- app> 


35 JSP 的 错误 处 理 


JSP 中 的 错误 有 两 种 : 一 种 是 编译 错误 , 当 Web 容器 在 编译 由 JSP 页 面 转换 成 
Servlet 源 文件 时 ,如 果 Servlet 文件 无 法 通过 Java 编译 检查 时 ,将 会 发 生 这 类 错误 ,错误 
代码 编号 为 500; 另 一 种 是 运行 时 出 现 的 错误 , 当 Web 容器 在 执行 已 编译 的 Java 字 节 码 
来 处 理 一 个 到 来 的 请 求 时 出 现 。 

尽管 Web 容器 对 于 JSP 中 的 错误 会 给 出 默认 的 处 理 ,但 有 时 制作 一 个 自己 的 错误 
处 理 页 面 会 显得 更 人 性 化 。 
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1 利用 page 指令 捕捉 编译 错误 

JSP 编译 错误 的 捕捉 可 以 通过 错误 页 面 转发 来 完成 。 采 用 这 种 方法 ,首先 要 制作 一 
个 错误 处 理 页 面 error. jsp, 并 在 页 面 的 page 指令 中 将 isErrorPage 属性 设置 为 true, 然 
后 在 所 有 需要 捕捉 错误 的 页 面 中 设置 page 指令 。 


< $@ page errorPage= "error.jsp" s> 


代码 3-16 给 出 了 一 个 具有 语法 错误 的 页 面 doLogin. jsp。 注 意 ,其 中 的 “String 
password 一 request. getParameter("password")” 语 句 后 面 缺少 了 一 个 分 号 ";”, 该 页 面 将 
错误 转发 到 error. jsp 中 进行 处 理 。 


代码 3-16 “page 指令 进行 出 错 处 理 (doLogin. jsp) 


< %@ page language= "java" pageEnooding= "UTF- 8" errorPage= "error.jsp"s> 
< 条 

String userNeme= request .getParameter ("userName"); 

String password= request .getParameter ("password") 


if ("zhangsan" .equals (userName) &&"123".equals (password) ) 
response. sendRedirect ("index.jsp"); 
%> 


代码 3-17 给 出 了 错误 处 理 页 面 error. jsp。 注 意 ,page 指令 中 的 isErrorPage 的 值 为 true。 
代码 3-17 出 错 处 理 页 面 (error. jsp) 


< $@ page language= "java" pageEnooding= "UIF- 8" isErrorPage= "true"s> 
<htm> 
<head> 
<title> 留 言 板 出 错 啦 < /title> 
< /head> 
<body> 
< img alt="" src= "images/logo.png'> 
<h2> 留 言 板 程 序 出 错 啦 ! 请 与 管理 员 联 系 < /h2> 
<hr/> 
< 和 excepticn.getMessage ()%> 
< /body> 
</htn> 


如 果 运 行 doLogin. jsp 程序 ,将 出 现 如 图 3-7 所 示 的 界面 。 


2 利用 Webxmr 配置 错 误 处 理 页 面 

对 于 运行 时 发 生 的 错误 ,无 法 利用 page 指令 进行 处 理 。 常 见 的 运行 时 错误 包括 
HTTP 400( 请 求 无 效 ) .HTTP 403( 禁 止 访问 ) 和 HTTP 404( 无 法 找到 文件 )。 程 序 员 
可 以 在 站 点 文件 web. xml 中 配置 处 理 这 一 类 错误 的 页 面 。 

代码 3-18 给 出 了 一 个 用 于 处 理 错误 的 web. xml 实例 。 这 里 将 400 和 404 错误 处 理 
页 面 指定 为 error. html。 
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留言 板 程序 出 错 啦 ! 请 与 管理 员 联系 


Unable to compile clase for JSP: Mn error occurred at line; 4 in the jsp file: /doLogin jep | 
Sntax error，insert“;”to complete LocalYariableDeclarationStatement 1: (WG page 

languagc= “java” pageEncodirg="UIF-8"%> 2: % 3: String userNane = 

requcst, gctParameter ("uscrName”); 4: String pessword = ee BctParamctcr (“password”) 5: 

6: if( “zhangsan“ .equals(userNane) 好 “123". equals (passnord)) 7: 

response. sendRedirect ("index. jsp”); Stacktrace: 


图 3-7 出 错 处 理 页 面 运 行 结果 


代码 3-18 利用 web. xml 配置 错误 处 理 


< ?ml version= "1.0" encoding= "UIF- 8"?> 
< web- app versicn= "2.5" 
xmlns= "http://java.sun.om/xml /ns/javaee" 
xmlns:xsi= "http://www.w3.org/2001/XMLSchema— instancen 
xsi:schemaLocation= "http://java.sun.oam/xml/ns/javaee 
http://java.sun.om/xml/ns/javaee/web- arp 2 5.x3d"> 
<error- page> 
< error- code> 500< /error- code> 
< location> /error.jsp< /locaticn> 
< /error- page> 
<error- page> 
< error- code> 400< /error- code> 
< location> /error.html< /locaticn> 
< /error- page> 
<error- page> 
< error- code> 404c /error- code> 
< location> /error.html< /location> 
< /error- pege> 
< /web- app> 


值得 一 提 的 是 ,这 种 方法 同样 适用 于 处 理 编译 时 发 生 的 错误 。 例 如 在 代码 3-18 中 ， 
将 500 错误 的 处 理 页 面 设 定 为 error. jsp, 此 时 就 不 必 在 所 有 的 页 面 中 再 利用 page 指令 
的 errorPage 属性 设置 出 错 页 面 了 


36 案例 1: 用 JSP 编 写 留 言 板 程序 


361 功能 分 析 
本 节 将 利用 前 面 讲 过 的 知识 ,设计 一 个 简单 的 公共 留言 板 程序 。 用 户 登录 之 后 ,可 


70 区 Web 应 用 程序 开发 技术 一 JSP 二 Struts 2 


以 看 到 所 有 的 留言 标题 的 列表 ;点 击 某 个 留言 标题 ,可 以 查看 留言 的 内 容 ; 点 击 留言 按 
钮 ,可 以 实现 留言 功能 。 

之 前 使 用 JDBC 操作 数据 库 ,都 是 直接 在 JSP 页 面 中 写 JDBC 代码 。 这 样 导 致 JSP 
页 面 中 包含 大 量 的 HTML 代码 和 Java 代码 ,显示 和 功能 代码 混在 一 起 ,维护 比较 困 
难 。 为 解决 该 问题 ,将 采用 在 实际 开发 中 广泛 使 用 的 DAO 设计 模式 来 编写 这 个 小 
程序 。 

DAO 抽象 与 封装 所 有 对 数据 源 的 访问 ;负责 管理 对 数据 源 的 连接 ,以 及 数据 的 存 
取 。DAO 包括 五 个 重要 的 部 分 ,分 别 如 下 。 

(1) 数据 库 连接 类 : 主要 功能 是 连接 数据 库 并 获得 连接 对 象 , 以 及 关闭 数据 库 。 通 
过 数据 库 连接 类 可 以 大 大 地 简化 开发 ,在 需要 进行 数据 库 连 接 时 ,只 需 创 建 该 类 的 实例 ， 
并 调用 其 中 的 方法 就 可 以 获得 数据 库 连接 对 象 和 关闭 数据 库 , 不 必 重 复 操作 。 

(2) PO 类 : 持久 化 类 ,包含 的 属性 和 数据 库 表 中 的 字段 一 一 对 应 ,数据 库 中 有 多 少 
个 表 就 应 该 有 多 少 个 PO 类 。PO 类 是 一 个 标准 的 JavaBean, 每 个 属性 都 应 提供 get 和 
set 在 法 5 

(3) DAO 接口 : 定义 了 所 有 的 用 户 操作 ,例如 添加 删除 和 查询 记录 等 。 

(4) DAO 实现 类 : 实现 了 DAO 接口 。 一 个 DAO 实现 类 对 应 一 个 表 , 实 现 了 与 该 表 
有 关 的 所 有 操作 。 

(5) DAO 工厂 类 : 在 没有 DAO 工厂 类 的 情况 下 ,必须 通过 创建 DAO 实现 类 的 实例 
才能 完成 数据 库 操作 ,对 于 后 期 的 修改 非常 不 便 , 极 端 情况 下 可 能 会 需要 修改 每 一 个 
DAO 实现 类 的 代码 。 使 用 DAO 工厂 类 可 以 很 好 地 解决 后 期 修改 的 问题 ,可 以 通过 该 
DAO 工厂 类 的 一 个 静态 方法 来 获得 DAO 实现 类 实例 。 这 时 如 果 需 要 替换 DAO 实现 
类 ,只 需 修改 该 DAO 工厂 类 中 的 方法 代码 ,而 不 必修 改 所 有 的 操作 数据 库 代 码 。 

限于 读者 目前 掌握 的 知识 ,本 程序 在 实现 页 面部 分 时 仍然 采用 艇 入 JSP 脚本 的 形 
式 。 在 学 习 Struts 2 知识 的 过 程 中 ,我 们 将 逐步 将 其 改造 ,使 之 完全 遵循 MVC 模式 。 


362 数据 库 结 构 


本 程序 将 采用 SQL Server 2005 Express 作为 数据 库 平 台 , 共 包括 两 张 表格 : 留言 表 
notes 和 用 户 表 users, 具 体 结构 如 表 3-3 和 表 3-4 所 示 。 


表 3-3 notes 表 
属性 名 类 型 说 明 
noteld int 留言 ID , 主 码 , 默 认 IDENTITY(1,1) 
title varchar(32) 留言 的 主题 
content varchar(200) 留言 的 内 容 
pubTime datetime 留言 的 时 间 
userld int 留言 人 ID 
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表 3-4 users 表 
属性 名 类 型 说 明 
userld int 用 户 人 D, 主 码 , 默 认 IDENTITY(1,1) 
userName varchar(20) 用 户 名 
password varchar(10) 密码 
head varchar(20) 头像 
regTime datetime 注册 时 间 
gender smallint 性 别 
363 实现 PO 类 
每 个 数据 表 都 应 映射 到 一 个 持久 化 类 。 代 码 3-19 给 出 了 notes 表 和 users 表 对 应 的 
PO 类 。 
代码 3-19 PO 类 
/* Notes.java * / 


package jNotes.bean; 

import java.sql.Timestampy 

Piblic class Notes { 
Private int noteId; 
private String title; 
Private String oontent; 


Private Timestamp pubTime; 


Private User user; 


/* 省 略 了 set 和 get 方 法 * / 


/# Users ,java # / 

Package jNotes .bean; 

import java.util.Date; 

Public class User implements{ 
Private Integer userId; 
Private String userName; 
Private String password; 
Private String head; 
Private Date regTime; 
Private String email; 
Private int gender; 


/* 省 略 了 set 和 get 方 法 * / 


364 ”DAO 接口 设计 


DAO 接口 层 使 得 低级 别 的 数据 访问 逻辑 与 高 级 别 的 业务 逻辑 分 离 , 可 以 隐藏 持久 
化 操作 的 细节 。 代 码 3-20 定义 留言 板 程序 的 DAO 类 的 接口 ,并 在 接口 中 定义 所 有 的 业 
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务 方法 和 数据 操作 方法 。 
代码 3-20 ”留言 板 程序 的 DAO 接口 


/# NotesDao.java * / 

package jNotes.dao; 

import jNotes.bean.Notes; 

import java.util .List; 

Public interfaoe NotesDao { 
Public int adoNote (Notes note); 
Public List< Notes> getAllNotes (); 
Public Notes getNoteById (int noteId); 

} 


/* UserDao.jeva * / 

Package jNotes.dao; 

import jNotes.bean.User; 

piblic interface UserDao { 
Public User findUser (int userId); 
Public User findUser (String userName, String password); 
Public int addUser (User user); 

3 


NotesDao. java 定义 了 访问 留言 表 的 三 个 方法 : 用 于 添加 新 留言 的 addNote() 方 法 、 
用 于 获取 所 有 留言 列表 的 getAllNotes() 方 法 和 用 于 根据 留言 ID 获取 留言 详细 信息 的 
getNotesById() 方 法 。 

UserDao. java 定义 了 访问 用 户 表 的 三 个 方法 : 根据 用 户 ID 查找 用 户 findUser( ) 方 
法 ,根据 用 户 名 和 密码 查找 用 户 的 findUser() 方 法 以 及 添加 新 用 户 的 方法 addUser() 。 


365 数据 库 连 接 和 DAD 实 现 类 


DAO 实现 类 用 于 实现 DAO 接口 。 为 简化 操作 ,本 程序 先 定义 了 一 个 BaseDao 类 ， 
提供 了 获取 数据 库 连接 操作 getConn() 方 法 、 关 闭 连 接 操作 closeAll10) 方 法 和 执行 数据 
库 更 新 语句 的 executeSQL() 方 法 。 代 码 3-21 给 出 了 BaseDao 类 的 实现 细节 。 

代码 3-21 BaseDao. Java 


Peckage jNotes.dao.irpl; 


dmport java.sql.* ;» 
dmport javax.naming. * ; 
import javax.sql .DataSouroe; 
Public class BaseDao { 
Piblic Connecticn getComn() 
throws ClassNotFoundExosption, SOLExosption{ 
Connecticn conr= mull; 
try{ // 根 据 hrr 获 取 数 据 源 
Context ic=new InitialContext () 7 
Datasource source= (DataSouroe) 


第 3 六 ”深入 JSP < 


ic.lookup ("java:oqmp/env/jdbc/notes"); ”//JNDI 名称 notes 
connr source.getConnecticn (); 
} catch (SQLExcepticn excepticn) { 
exception.printstackrrace (); 
} catch (emingException namingExcepticn) { 
mamingException.printStackTrace (); 
} 
retum conn7 


Public void closeAll (Connecticn oomn, PreparedSstatement pstmt, 
ResultSet rs){ 

if(rs (=mll){ // 关 闭 结 果 集 
try { rs.close();} 
catch (SQLException e) {e.printStackTrace();} 

’ 

if(pstt (=mll){ // 关 闭 语句 
try { pstrt.close();} 
Catch (SQLException e) {e.printStackTrace();} 


在 (conmn !=mll){ // 关 闭 连接 


try { oonn.close();} 
Catch (SQLException e) {e.printStackTrace();} 


Public int executeSQL (String preparedsql, String[] Param { 


Connecticn conr= mull; 

PreparedStatement pstmt—=rull; 

jb mm=0; 

try{ // 构 造 preparestatement 语句 的 参数 
conn= getConn () 7 
Pstmt= conn.PrepareStatement (preparedsql) 7 


if(param !=mnull) { 
for (int i=0; i <param.length; i++) { 
pstmt.setString(i+ 1, param[i]); 


. 

nnE pstmt .executeUpdate () 7 
} catch (ClassNotFoundExosption e) { 
e.PrintStackrrace (); 
} catch (SQLExosption e) {e.printStackTrace ();} 
finally {closeAll (comn,pstmt,mll);} 
retum nm; 
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NotesDaoImpl 类 和 UserDaoImpl 类 扩展 该 类 ,参见 代码 3-22。 
代码 3-22 DAO 实现 类 


/* NotesDaoInrpl.java* / 

Peckage jNotes.dao.impl; 

dmport jNotes.bean.* ; 

import jNotes.dao.NotesDao; 
import java.sql.* ; 

dmport java.text.SimplepateFormat; 
dmport java.util.* ; 

jmport java.util .Date; 


Public class NotesDaoTrpl extends BaseDao implements NotesDao { 
Private Connecticn conn= rull; 
Private Preparedstatement pstmt= null; 
Private ResultSet rs=nmll; 


Public int addNote (Notes note) { 
String sql= "insert into notes (oontent, pubTime, title, userId) values(?,2,3,3) "; 
String time= new SimpleDateFormat ("yyyy- M4- dd HH:mm: ss") 
.format (new Date()); // 用 服务 器 当前 作为 留言 时 间 
String[] param= {note.getContent (),time,note.getTitle()， 
note.getUser () .getUserTd () .toString () 
;3 // 蕉 备 SQL 语句 的 参数 
Tebum this.executeSgL(sql, param); 。 // 调 用 BaseDao 的 executesoL 方 法 
} 


Public List< Notes> getAllNotes() { 
List< Notes> list= new ArrayList< Notes> (); 
String sql= "select * fram notes order by pubTime desc"; 


try{ 
conn= this.getConn 0) 7 // 获 取 数 据 库 连 接 
Pstmt= conn.prepareStatement (sql); // 获 取 PrepareStatement 对 象 
Is Pstmt.executeQuery()7 // 执 行 查询 
while(rs.next ()){ // 依 次 取出 查询 结果 中 的 每 一 条 数据 ,保存 到 list 中 


Notes note= new Notes (); 
note. setNotelId (rs.getInt ("noteId") ); 
note.setTitle (rs.getSstring ("title")); 
// 获 取 当 前 留言 人 的 信息 
User user= new UserDaoIrp]l () .findJser (rs.getInt ("userId") ); 
pote.setUser (user); 
list.add (note); // 将 一 条 留言 保存 到 list 中 
} 
}oatch (Exception e) {e.printStackTrace();} 
finally{this.closeAll (conn， pstmt, rs); } 
retum list; 
} 


Piblic Notes getNoteById (int noteId) { 
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Notes note= new Notes (); 
String sql= "select * fram notes where noteId= "+ noteId; 


try{ 
conn=this.getcomn0; // 获 取 数 据 库 连 接 
Patmb= com.prepareStatement (aq); ”// 获 取 PrepareStatement 对 象 
Ts Pstmt.executeQuery()7 // 执 行 查询 
if(rs.next (){ // 结 果 不 为 空 时 ,利用 查询 结果 构造 Note 对象 


note.setNoteId (rs.getInt ("noteId")); 
note.setContent (rs.getString ("ontent")); 
note.setPubTime (rs.getTimestamp ("pubTime") ); 
note.setTitle (rs.getString ("title")); 
// 获 取 当 前 留言 人 的 信息 
User user— neW UserDaoIrpl () .findUser (rs.getInt ("userId")); 
note.setUser (user); 
} 

]catch (Exoeption e) { e.printStackTrace();} 

finally {this.closeAll (oonn, pstmt, rs); } 

retum note; 


} 


/* UserDaoInpl.java * / 

Package jNotes.dao.inpl; 

import jNotes.bean.User; 

import jNotes .dao.UserDao; 

import java.sql.* ; 

jimport java.text .SinmpleDateFormat; 

import java.util.Date; 

public class UserDaoIrpl extends BaseDao implements UserDao { 
Private Connecticn conn= null; 
Private PreparedStatement pstmt= null; 
Private ResultSet rs=null; 


Public int aqqUser (User user) { 
String sql= "insert into users (userName, password, gender, 
head, regTime) values (?,?,"+ user.getGender ()+ ",?,3)"; 
String time= new SirmpleDateFormat ("yyyy— M4- dd HH:mm: ss") . 
fomat (new Date()); // 用 服务 器 当前 时 间作 为 用 户 注册 时 间 
String[] pame {user.getUserName (), user.getPassword(), 
user.getHead() ,time }; ”// 惟 备 QL 语句 的 参数 
retum this.executeSoL (sql, pamm); // 调 用 Basepao 的 executesoL 方 法 


Public User findUser (int userId) { 
String sql= "select * fram users where userId= 2"; 
User user= null; 
try{ 
conn= this.getCom(); /获取 数据 库 连接 
Pstmt= conn.prepareStatement (sql); // 获 取 Preparestatement 对 象 
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Petmt.setInt (1, userId); 
rs= pstmt .executeQuery(); // 执 行 查询 
whilel( rs-next()) { // 结 果 不 为 空 时 ,利用 查询 结果 构造 User 对 象 
user= new User (); 
user.setUserTd( rs.getInt ("userTd") ); 
User. setUserName ( r3.getString ("userName") ); 
User.setPassword( rs.getString ("password") ); 
user .setGender (rs.getInt ("gender")); 
user.setHead( rs.getString ("head")); 
User.setRegTime ( r3.getDate ("regTime")); 
} 
} catch (Exosption e) { e.printStackTraoce();} 
finally {this.closeAll (comn, pstmt, rs); } 
ITeturn user; 


Public User findUser (String userName, String password) { 
String sql= "select * fram users where userName= ? and password= ?2"; 
User user=null; 
try{ 
conn= this.getconn()7 /获取 数据 库 连 接 
pstmt= conn.prepareStatement (aq) ; // 获 取 PrepareStatement 对 象 
Pstmt.setString(1，userName) 7 
pstmt..setString (2, password); 


rs= pstmt .executieQuery (); // 执 行 查询 
while( rs.next()) { // 结 果 不 为 空 时 ,利用 查询 结果 构造 User 对 象 
User= new User (); 


User.setUserId( rs.getInt ("userId")); 

User .setUserName ( rs.getString ("userName") ); 
User.setPassword( rs.getString ("password") ); 
User.setGender (rs.getInt ("gender")); 
User.setHead( rs.getString ("head")); 
user.setRegTime ( rs.getDate ("regTime")); 


} 
} catch (Exosption e) {e.printStackTraoce();} 
finally {this.closeAll (oonn, pstmt, rs); } 
retum user; 


366 页 面 设计 

1 页面 布 局 

留言 板 程序 主要 包括 四 个 页 面 : 登录 页 面 login. jsp、 留 言 标题 列表 页 面 index. jsp、 
查看 留言 详细 内 容 页 面 detail. jsp 和 留言 页 面 post.jsp。 另 外 .还 包括 三 个 辅助 JSP 文件 
doLogin. jsp .doPost. jsp 和 logout. jsp。 


第 3 章 深入 JSP O01 


doLogin.jsp 
(验证 登录 ) 

_ | 登录 页 面 留言 标题 列表 留言 页 面 
(loginjsp) (index.jsp) (postjsp) 
logout.jsp Be doPost.jsp 

(注销 登录 ) (调用 PostDao 类 写 数据 库 ) 


图 3-8 留言 板 程序 页 面 关系 


一 个 好 的 应 用 程序 ,页 面 的 布局 是 非常 重要 的 。 基 于 表格 的 布局 不 再 符合 现代 软件 
开发 的 潮流 。 为 此 ,留言 板 程序 采用 CSS 十 DIV 的 方式 进行 布局 。 代 码 3-23 给 出 了 程序 
中 用 到 的 CSS 文件 。 


代码 3-23 “CSS 文件 (main. css) 


Q@CHARSET "UIF- 987 

.page{margin: 20p%, 1qpx;width: 960px;margin left:- 490nx7left:5087 
position:relative;} 

.header{fheight:700oxzmargin- bottam: 0;background image: 

Ur (./ imges/10g0.pn9) ;background- repeat:no- repeat; } 
-welomePanel {right: 1qox;postion:relative;float:right;} 
mainDivfmargin- left:13wrmargin- right:: 13qpx;width: 800px; } 
.collfmargin- top: 1Qpox;width: 2000x; text— align:right;float:1eft;} 
.0012{fmargin- top: 1qpow;width: 50qpx; float': right;} 

.leftalign{text— align:1eft} 

.Clear{clear:both;} 

.userName {margin— left:0. Sem;margin- right:0. Sem;oolor: red; } 

.ui- widget- header {background:#e78f08; oolor:# FFFFFF; font- weight:bold; 
height:30nxzvertical- align:middle;} 

.ui- widget— content {background:# eeesee;oolor:# 333333;} 


由 于 每 个 页 面 的 顶部 都 要 显示 LOGO, 都 要 对 用 户 是 否 登 录 进行 验证 。 从 模块 化 设 
计 的 角度 出 发 ,把 这 部 分 内 容 放 到 一 个 header. jsp 子 页 面 中 ,然后 通过 include 指令 包含 
到 其 他 页 面 中 。header. jsp 的 详细 内 容 如 代码 3-24 所 示 。 


代码 3-24 ”header. jsp 子 页 面 


< $@ page language= "java" jmport= "jNotes.bean. * " pageEnooding= "UIF- 8"%> 
< 


User user=null; 
if (null!= session.getAttribute ("user")) /* 检查 用 户 是 否 登录 * / 
User= (User) session.getAttribute ("user"); 


else /# 用 户 未 登录 时 , 重 定向 到 登录 页 面 * / 


response.sendRedirect ("Jogin.jsp"); 
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$> 
< div class= "header"> 
< div class= "welomePanel"> 
<%if(null!=user) { $> 
欢迎 < span class= "userNeme"> < $=user.getUserName() $>< /span> 回 来 
< img alt= mm src= "images/split.jpg> 
<a hre= "ogout.jsp"> 登 出 < /a> 
<$} > 
</div> 
< /div> 


2 用 户 登 录 
用 户 登 录 部 分 由 3 个 文件 组 成 : login. jsp、doLogin. jsp 和 logout. jsp。 
(1) login. jsp 页 面 提供 了 用 户 登录 界面 ,如 代码 3-25 所 示 。 


代码 3-25 login. jsp 


< $0 page language= "java" import= "java.util. * " pageEnooding= "UTEF- 8"%> 
<%/* 如 果 用 户 已 经 登录 ,直接 转 到 index.jsp 页 面 * / 
if(null!= session.getAttribute ("user")) 
response.sendRedirect ("index.jsp"); 
多 > 
<html> 
<head> 
<title> 欢 迎 登录 JSP 留 言 板 < /title> 
< link rel= "stylesheet" type= "text/css" href= "style/main.css"> 
<style>< !-- 登 录 页 面 中 用 到 的 样式 --> 
.itemfpactiingr- left:380px;position:relative;padding- bottam:10px; } 
.label {width:360px;position:absolute; left:0;text— align:right;} 
</style> 
< /head> 
<body> 
< div class= "header"> < /div> 
< div class= ui- widget- header" style- "text- aligqn:oenter"> 登录 < /div> 
< div class= "ui- widget— omtent"> 
< fom id- "forml" acticnr "doLogin.jsp" method "post"> 
<div> 
< span class= "labelw> 用 户 名 < /span> 
<div class= "item"> < input name= "userName" id= "username"/> < /div> 
</div> 
<div> 
< span class- "label"> 密 码 < /span> 
<div class= "item"> < input name= "password" type= "password"/> 
</div> 
</div> 
<div class= "item> 
<input type= "submit" value= " 唤 认 "> 
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< input type= "reset" value= " 重 写 "/> 
</div> 
< /fom> 
</div> 
< /body> 
</htm> 


(2) doLogin. jsp 用 于 获取 Login. jsp 中 传递 过 来 的 请 求 参 数 ,并 调用 UserDao 接口 
的 findUser() 方 法 验证 用 户 身份 ,如 代码 3-26 所 示 。 


代码 3-26 doLogin. jsp 


< $@ page language= "java" pageEnooding= "UTF- 8" import= "jNotes.bean. * , jNotes.dao. * , jNotes. dao. 
impl.x ""%> 
< 条 
/* 将 获取 的 请 求 参 数 转 码 ,以 解决 中 文 乱码 问题 * / 
String userName= new String( 
request .getParameter ("userName") .getBytes ("TSO- 8859- 1"), 
"UIE- 8"); 
String password= new String( 
request .getParameter ("password") .getBytes ("ITSO- 8859- 1"), 
"UIFE- 8"); 
/* 调用 UserDao 接 口 的 finanser( 方 法 ,验证 用 户 身份 * / 
UserDao userDao= new UserDaoIrpl (); 
User user= userDao.finqUser (userName, password); 
寺 al !=user) { /* 通 过 身份 验证 ,保存 到 sessicn, 并 重 定向 到 index.jsp* / 
3ession.setAttribute ("user", user); 
response.sendRedirect ("index.jsp"); 
} else { /* 未 通过 身份 验证 , 重 定向 到 login.jsp* / 
response. sendRedirect ("login.jsp"); 
} 
%> 


(3) logout. jsp 注销 登录 
注销 登录 如 代码 3-27 所 示 。 


代码 3-27 logout. jsp 


< 
session.removeAttribute ("user"); // 从 sessicn 中 删除 user 


response.sendRedirect ("ogin.jsp"); // 重 定向 到 登录 页 面 
多 > 


图 3-9 给 出 了 登录 页 面 的 界面 。 

3 查看 留言 列表 indexjsp 

index. jsp 使 用 DAO 接口 ,获取 所 有 的 留言 信息 ,并 显示 在 页 面 中 。 代 码 3-28 给 出 
了 index. jsp 文件 的 内 容 , 并 附 有 详细 的 注释 ,在 此 不 再 袭 述 。 
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[EET 3 
< 30 012.00.1 jotes/lo8gin. jsp 


图 3-9 登录 页 面 


代码 3-28 index.jsp 


< $@ page language= "java" PageEncoding= "UTF- 8" 
import= "java.util. * ,jNotes.dao. * ,jNotes.dao.impl.* " %> 
< 名 /* 获 取 所 有 留言 列表 * / 
NotesDao notesDao= new NotesDaoTrpl (); 
List< Notes> list=notesDao.getAllNotes (); 
%> 
<html> 
<head> 
<title> 留言 列表 < /title> 
< link rel= "stylesheet" type= "text/css" href= "style/main.css"> 
< /head> 
<body> 
< $8 include file= "header.jsp" %> < 上 -包含 header.jsp 子 页 面 --> 
<a href= "post..jsp"> < img src= "images/book write.png"/>< /a> 
< div class=" ui- widget- header" styler "text- align:oenter;"> 留言 列 表 
</div> 
<div class= "collw> 留 言 人 < /div> 
<div class= "col2w> 主题 < /div> 
< 名  /* 和 迭代 留言 列表 ,利用 动态 生成 的 div 显 示 留 言 人 和 留言 主题 * / 
Iterator< Notes> it= list.iterator (); 
while (it.hasNext ()) { 
Notes note= it .next ();» 
%> 
< div class= "clear> < /div> 
<div class= "coll"> 
<$=note.getUser() .getUserName() $>< !-- 显 示 留 言 人 --> 
</div> 
<div class= "col2"> 
<a href= "detail .jspanoteId= < $=note.getNoteId() $>"> 
< 和 -note.getTitle() $>< !-- 动 态 构造 每 条 留言 的 URL --> 
</div> 
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< /body> 
</htbnl> 


4 查看 留言 内 容 

detail. jsp 根据 index. jsp 页 面 传 过 来 的 留言 ID, 调 用 DAO 接口 获取 留言 的 详细 信 
息 ,并 显示 在 页 面 中 。 代 码 3-29 给 出 了 detail. jsp 文件 的 内 容 , 并 附 有 详细 的 注释 ,在 此 
不 再 歼 述 。 


代码 3-29 detail. jsp 


< $@ page language= "java" import- "jNotes.dao. * ,jNotes.dao.impl.* " 
pageEnooding= "UIF- 8"%> 
<%/* 从 请 求 参 数 中 获取 留言 的 ID --> 
int noteId= Integer.parseInt ( 
request .getParameter ("noteId") .toString()); 
/* 根 据 留 言 ID, 获 取 留 言 的 详细 信息 * / 
Notes note= DaoFactory.getNotesDao () .getNoteByTd (noteId) ; 
%> 
<html> 
<head> 
<title> 留 言 内 容 < /title> 
< link rel= "stylesheet" type= "text/css" href= "style/main.css"> 
< /head> 
<body> 
<$%@ include file= "header.jsp" $>< !-- 包 含 header.jsp 子 页 面 --> 
<a href= "post .jsp"> < img src= "images/book write.Png"/>< /a> 
< div class= ui- widget- header" style= "text- align:center;"> 留 言 内 容 
</div> 
<div class= "collw> 留 言 人 < /div> 
<div class= "co12"> 内 容 < /div> 
<div class= "clear">< /div>< !-- 清 除 div 浮动 效果 --> 
<div class= "coll leftalign">< !-- 显 示 留 言 人 信息 和 留言 内 容 --> 
< img srcr "imeges/head/< $=note.getUser () .getHead() $>"/><br/> 
用 户 名 :<%=note.getUser() .getUserName () %$><br/> 
注册 时 间 :<s= note.getUser () .getRegTime() s> 
</div> 
<div class= "col2"> <$=note.getContent () $>< /div> 
< /body> 
</html> 


图 3-10 给 出 了 查看 留言 内 容 页 面 的 运行 效果 。 

5 留言 

post. jsp 为 用 户 创建 新 的 留言 提供 了 接口 。 代 码 3-30 给 出 了 post. jsp 文件 的 内 容 ， 
并 附 有 详细 的 注释 ,在 此 不 再 歼 述 。 
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用 户 名 :大 和 牛 各 
注册 时 间 :2011-12-132 4 


图 3-10 留言 内 容 


代码 3-30 post. jsp 


< $0 page language= "java" import= " jNotes.dao. * ,jNotes.dao.impl.* " 
PageFnooding= "UIF- 8"%> 
<html> 
<head> 
<title> 新 留言 < /title> 
< link rel= "stylesheet" type= "text/css" href= "style/main.css"> 
< /head> 
<body> 
<$@ include file= "header.jsp" s>< !-- 包 含 header.jsp 子 页 面 --> 
<div class= "mainDiv"> 
< div class= ui- widget- header" style= "text- align:oenter;"> 新 留言 
</div> 
< form name= "forml" action= "doPost .jsp" type= "post"> 
<div class= "collw> 标 题 < /div> 
<div class= "col2"> < input name= "title" size= "50" />< /div> 
<div class= "collw> 内 容 </div> 
<div class= "col2"> 
< textarea rows= "20" cols= "60" name= "content"> < /textarea> 
<br/> ( 少 于 200 字 ) 
</div> 
<div class= "col2"> 
< input type= "suibmit" value= "确定 " /> 
< input type= "reset" /> 
</div> 
< /fom> 
</div> 
< /body> 
</htm> 


3-11 给 出 了 创建 新 留言 页 面 的 运行 效果 。 
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图 3-11 留言 页 面 


doPost. jsp 负责 接收 post. jsp 传递 过 来 的 参数 ,调用 DAO 接口 中 的 相应 方法 将 留 
言 的 内 容 保 存 到 数据 表 中 ,最 后 重 定向 到 留言 列表 页 面 index. jsp, 如 代码 3-31 所 示 。 


代码 3-31 doPost. jsp 


< $@ page language= "java" pageEnooding= "UTF- 8" 
jimport= " jNotes.bean. * ,jNotes.dao. * ,jNotes.dao.impl.* "%> 
<% 
/* 接收 请 求 参数 ,并 解决 中 文 乱码 * / 
String titler new String (request. .getParameter ("title") 
.getBytes ("TSO- 8859- 1") , "UTE- 8"); 
String content= new String (request .getParameter ("oontent") 
.getBytes ("ITSO0- 8859- 1"), "UTE- 8") 7 
Notes note= new Notes () 7 
note.setContent (content)7 
note.setTitle (title)7 
note.setUser ( (User) session.getAttribute ("user")); 
NotesDao noteDao= new NotesDaoTrpl (); 
noteDao.addNote (note) ; /* 调用 Notespao 接 口 */ 
response.sendRedirect ("index.jsp"); 
多 > 


同步 训练 


1. 利用 3.6 节 给 出 的 DAO 接口 ,为 留言 板 程序 增加 用 户 注 册 功 能 。 

2. 仿照 3.6 节 给 出 的 留言 板 程序 样 例 , 设 计 一 个 站 内 短信 系统 。 要 求 如 下 : 
(1) 设计 合理 的 数据 库 结构 ; 

(2) 编写 PO 类 和 DAO 类 ; 

(3) 实现 用 户 注册 登录、 站 内 短 信 查 看 、 回 复 、 写 信 以 及 注册 用 户 查 询 等 功能 。 


hapter 4 
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Struts 2 是 一 个 开源 的 Web 开发 框架 , 它 由 两 部 分 组 成 : XWork 2 和 Struts 2。 
XWork 是 一 个 命令 模式 框架 , 它 提供 了 Struts 2 框架 的 核心 功能 : IoC( 控 制 反 转 ) 容 器 、 
强大 的 表达 式 语言 (OGNL) ,数据 类 型 转换 ,输入 验证 和 可 插入 的 配置 。XWork 框架 的 
核心 概念 包括 action ,拦截 器 (interceptor) 和 result。Struts 2 扩展 了 这 些 概念 的 基础 实 
现 , 用 于 支持 Web 应 用 程序 的 开发 。 

Struts 2 框架 具有 如 下 特点 。 

(1) 基于 Action 的 框架 。Struts 2 将 处 理 用 户 请 求 的 迎 辑 封装 到 了 Action 类 中 ,并 
通过 使 用 Struts. xml 完成 客户 请 求 和 Action 类 的 映射 关系 ,避免 了 纯 JSP 编程 中 由 于 
HTML 标签 和 JSP 代码 混合 所 带 来 的 难以 维护 的 问题 。 

(2) Struts 2 采用 XML 文件 作为 映射 , 校 验 、 类 型 转换 和 国际 化 处 理 时 的 配置 ,提高 
了 应 用 程序 的 可 维护 性 。 

(3) Struts 2 整合 了 OGNL(Object-Graph Navigation Language) 。 作 为 一 种 功能 强 
大 的 表达 式 语言 ,OGNL 提供 了 一 种 简单 一 致 的 表达 式 请 法 ,用 于 存 取 对 象 的 每 个 属性 ， 
调用 对 象 的 方法 ,实现 字段 类 型 转化 等 功能 。 

(4) Struts 2 提供 了 自己 的 标签 库 ,通过 与 OGNL 联合 使 用 ,使 得 用 户 能 够 更 容易 地 
编写 表示 层 。 

(5) Struts 2 能 够 很 方便 地 与 其 他 流行 框架 结合 使 用 。 例 如 ,与 Spring 结合 使 用 ,可 
以 充分 利用 Spring 的 IoC 技术 ,促进 系统 的 松 耦 合 :与 SiteMesh 结合 使 用 ,能 够 帮助 网 
站 开发 人 员 较 容易 地 实现 页 面 中 动态 内 容 和 静态 装饰 外 观 的 分 离 :与 Hibernate 或 
iBatis 结合 使 用 ,可 以 减少 程序 员 进行 持久 化 处 理 的 工作 量 。 

(6) Struts 2 拥有 由 积极 活跃 的 开发 人 员 与 用 户 组 成 的 成 熟 社 区 ,是 当前 最 为 流行 
的 Web 开发 框架 技术 之 一 。 


42 创建 Struts 2 应 用 程序 


421 Struts 2 开发 步骤 


要 使 用 Struts 2 进行 Web 开发 .首先 要 从 http://struts. apache. org/download. cgi 
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下 载 Struts 2 开发 包 。 作 者 在 编写 本 书 时 ,Struts 2 的 最 新 版 本 为 2. 3. 4。Apache 为 开 
发 者 提供 了 很 多 压缩 包 ,建议 初学 者 下 载 完 整 版 (Full Distribution) , 即 struts-2. 3. 4-all. 
zip。 该 压缩 包 中 包含 Struts 2 的 文档 .示例 程序 、 源 文件 和 核心 类 库 以 及 Struts 2 所 依 
赖 的 类 库 等 。 

解压 struts 2. 3. 4-all. zip 后 ,可 以 得 到 如 下 目录 结构 。 

(1) apps: 该 文件 夹 包 含 基于 Struts 2 的 示例 程序 。 

(2) docs: 该 文件 夹 包含 Struts 2 的 相关 文档 ,包括 Struts 2 快速 入 门 、Struts 2 的 文 
档 以 及 API 文 档 等 内 容 。 

(3) lib: 该 文件 夹 包含 Struts 2 框架 的 核心 类 库 , 以 及 与 Struts 2 相关 的 所 有 第 三 
方 插件 类 库 。 

(4) src: 该 文件 夹 包 含 Struts 2 框架 的 全 部 源 代码 。 

准备 好 Struts 2 开发 包 之 后 ,就 可 以 进行 Struts 2 的 开发 工作 。 下 面 以 留言 板 程序 
的 登录 部 分 为 例 ,讲解 利用 Struts 2 进行 Web 应 用 程序 开发 的 流程 。 

首先 ,打开 myEclipse, 创建 一 个 Web Project。 然 后 ,按照 下 述 步骤 进行 配置 和 
开发 。 

1 准备 类 库 

不 同 的 开发 需求 使 用 到 的 类 库 是 不 一 样 的 。 以 Struts 2-2. 3. 4 为 例 ,至 少 应 该 包含 
以 下 7 个 JAR 包 。 

(1) xwork-core-2. 2. 1. jar: XWork 类 库 ,Struts 2 框架 的 基础 。 

(2) Struts 2-core-2. 2. 1.jar: Struts 2 框架 的 核心 库 。 

(3) commons-fileupload-1. 2. 1. jar: Struts 2 用 于 上 传 文件 的 类 库 ,无 论 应 用 程序 中 
是 否 用 到 了 文件 上 传 功能 ,必须 包含 本 类 库 。 

(4) commons-io-1. 3. 2. jar: 通用 输入 输出 类 库 。 

(5) ognl-3.0.jar: 对 象 图 导航 语言 ,Struts 2 使 用 的 一 种 表达 式 语 言 。 

(6) freemarker-2. 3. 16. jar: Struts 2 的 UI 标签 的 模板 是 使 用 FreeMarker 编写 的 ， 
无 论 在 应 用 程序 中 是 否 用 到 了 Struts 2 标签 ,必须 包含 本 类 库 。 

(7) javassist-3.7. ga, jar: 用 于 动态 编辑 、 生 成 Java 字 节 码 的 类 库 。 

将 上 述 类 库 复制 到 Web 应 用 的 WEB-INF/lib 文件 夹 中 。 

2 配置 FlterDispatcher 

首先 ,在 web. xml 文件 中 配置 Struts 2 的 核心 控制 器 StrutsPrepareAndExecuteFilter。 
该 控制 器 负责 加 载 Struts 2 的 相关 配置 文件 ,用 来 拦截 客户 端 请 求 ,并 把 请 求 转发 到 相应 
的 Action 类 来 处 理 ,如 代码 4-1 所 示 。 


代码 4-1 web. xml 


< ?ml version= "1 .0" encoding= "UIE- 8"?> 
< display- name> Struts Blank< /display- name> 
<filter> 
< filter- neme> struts2< /filter- neme> 
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<filter- class> 
Crg.aeche.struts?.dispatcher .ng.filter.StrutsPreperemrcEyeoteFi lber 

< /filter- class> 

</filter> 

<filter- mepping> 
< filter- neme> struts2< /filter- name> 
<Url- pattern> /* < /url- pattem> 

< /filter- mapping> 

<welcome file list> 
< welome- file> index.html< /welcome file> 

< /welome- file- list> 

< /web- app> 


web. xml 中 关于 配置 这 一 步 是 固定 的 ,大 家 可 以 在 做 好 一 个 web. xml 文件 后 保存 
起 来 ,以 后 再 编写 Struts 2 应 用 时 直接 将 其 复制 过 去 即 可 。 

注意 : 核心 控制 器 StrutsPrepareAndExecuteFilter 的 本 质 就 是 一 个 Servlet 过 滤器 ， 
这 里 把 url-pattern 配置 成 /* ,意思 是 让 控制 器 拦截 所 有 的 用 户 请 求 。 如 果 在 Web 应 用 
程序 中 还 需要 编写 部 分 Servlet 类 ,应 该 将 url-pattern 配置 成 . action。 此 时 ,控制 器 将 只 
拦截 url 扩展 名 为 .action 的 用 户 请 求 ,而 不 会 处 理 Servlet 请 求 。 


3 创建 业务 控制 器 LognAcio 

Struts 2 的 业务 控制 器 就 是 一 个 POJO(Plain Old Java Objects, 简 单 的 Java 对 象 ) 。 
该 POJO 类 包含 多 个 属性 ,用 于 封装 用 户 的 请 求 参 数 和 需要 呈现 给 客户 端的 数据 ,并 提 
供 了 一 个 返回 类 型 为 String 的 公共 方法 用 于 处 理 用 户 的 请 求 。 默 认 时 ,该 方法 为 
execute() ,如 代码 4-2 所 示 。 


代码 4-2 LoginAction. java 


Package exanple.action; 
public class LIcginaction { 


private String userNeme; // 定 义 登录 名 称 属性 
private String password; // 定 义 登录 密码 属性 
/省 略 了 get 和 set 方 法 的 代码 ,请 读者 自行 添加 * / 
Public String execute() { // 登 录 验 证 
if ("zhangsan".equals (usermame) &&"123".equals (password)) 
retum "sucoess"; // 登 录 成 功 返 回 success 
else 
retum "login"; // 登 录 失 败 返回 login 


4 创建 视图 页 面 

编写 留言 板 程序 的 登录 页 面 login. jsp, 如 代码 4-3 所 示 。 注 意 ,login. jsp 中 form 的 
action 属性 的 取 值 为 login. action。 如 果 在 web. xml 中 ,核心 控制 器 拦截 的 URL 后 级 
为 /* ,可 以 省 略 这 里 的 扩展 名 . action。 
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代码 4-3 login. jsp 


< 上 -login.jsp 文 件 源码 一 > 
< $@ page contentType= "text/html; charset— utf- 8" language= "javans> 
<html> 
<head> 
<title> 登 录 < /title> 
< /head> 
<body> 
< fom action= "login.action" method= "post"> 
用 户 名 : < input type= "text" name= "userNeme" /><br /> 
密 grbep;&rbep; 码 : < irput type= "Password" nere= "pessword" /><br /> 
< input type= "submit" value= "登录 " /> 
< /fom> 
< /body> 
< /himl> 


5 创建 欢迎 页 面 wecorejsp 
编写 登录 成 功 后 的 欢迎 页 面 welcome. jsp, 如 代码 4-4 所 示 。 


代码 4-4 欢迎 页 面 welcome. jsp 


< $Q page language= "java" pageEncoding= "UTF- 8"%> 
<s@ taglib uri= "/struts- tags" prefix— "s" $> 
<html> 
<head> 
<title> 登 录 成 功 < /title> 
</head> 
<body> 
<h2> 
< s:property value= "userNeme"/> 您 好 ,欢迎 登录 系统 ! 


6 配置 LognAcion 

为 了 让 Action 能 处 理 用 户 的 请 求 ,还 需要 在 struts. xml 文件 中 配置 Action。 
struts. xml 文件 存放 在 classes 路 径 下 ,在 利用 myEclipse 开发 时 可 以 直接 放 在 src 目录 
下 。 在 struts. xml 文件 中 配置 Action 时 ,用 name 属性 定义 该 Action 的 名 称 , 用 class 定 
义 这 个 Action 的 实际 实现 类 。 由 于 当 Action 处 理 完 客 户 端 请 求 后 返回 一 个 字符 串 , 每 
个 字符 串 都 将 对 应 一 个 视图 。 因 此 ,配置 Action 时 ,需要 为 每 个 Action 指定 result 元 
素 ,定义 Action 返回 字符 串 对 应 的 视图 。 

在 代码 4-5 中 定义 了 一 个 名 字 为 login 的 Action, 其 实现 类 为 example. action. 
LoginAction。 该 Action 将 负责 处 理 URL 为 login. action 的 用 户 请 求 。 处 理 时 ,Action 
将 调用 它 的 execute() 方 法 处 理 用 户 请 求 。 如 果 execute() 方 法 返回 结果 字符 串 success， 
则 请 求 将 被 转发 到 /success. jsp 页 面 ;如 果 execute() 方 法 返回 login, 则 请 求 被 转发 到 
login. jsp 页 面 。 
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代码 4-5 struts. xml 


< ?ml version= "1.0" encoding= "UIF- 8" 2> 
< !IDOCTYPE struts PUBLIC 
™ //Apache Software Foundation//DID Struts Configuration 2.3//EN" 
"http://struts.apadhe.org/dtds/struts- 2.3.dtd"> 
< struts> 
< package name= "default" namespace= "/" extends= "struts- default"> 
< action name= "login" class= "exenple.action.IoginAction"> 
< result name= "sucoess"> /welome.jsp< /result> 
< result name= "login"> /login.jsp< /result> 
< /action> 
< /package> 
< /struts> 


现在 ,在 myEclipse 中 将 notes 发 布 到 tomcat 下 ,并 启动 tomcat 服务 。 打 开 浏 览 器 
访问 http://localhost:8080/notes/ ,在 输入 完 用 户 名 和 密码 后 ,可 以 看 到 熟悉 的 留言 板 
主页 面 , 如 图 4-1 所 示 。 

国 x 
€ 3 CC O127.0.0.1:8080/notes/ 安 
请 您 登录 园 到 了 


用 户 名 ，|zhangsan € 3 CGI|G127.0.0.1:8080/notes/login act 家 | 世 


人 zhangsan 您 好 ， 欢 迎 登 录 系 统 ! 


图 4-1 留言 板 登录 页 面 和 登录 成 功 页 面 


下 面 分 析 该 程序 的 工作 流程 。 

(1) Struts 2 容器 收 到 login. action 请 求 , 从 web. xml 获取 核心 过 滤器 。org， 
apache. Struts 2. dispatcher. FilterDispatcher 是 所 有 应 用 (包括 * . action) 的 入 口 点 。 

(2) Struts 2 在 struts. xml 中 找到 loginAction 类 (Action) ,然后 调用 setUserName 
(和 setPassword() 方 法 分 别 为 属性 userName 和 password 赋值 ,并 调用 loginAction 类 
的 execute() 方 法 。 

(3) execute() 方 法 对 请 求 进行 处 理 , 并 根据 处 理 返回 不 同 的 结果 代码 ,Struts 2 收 到 
结果 代码 后 ,按照 映射 关系 ,把 相应 的 Web 页 面 返回 给 客户 端 。 

(4) 如 果 要 返回 给 客户 端的 是 页 面 welcome. jsp, 则 在 返回 前 ,一 s: property value 一 
"userName" /二 会 调用 LoginAction 类 getUserName() 方 法 ,获取 属性 userName 的 值 ， 
并 显示 在 页 面 上 。 

提示 : 初学 者 在 编写 和 执行 第 一 个 Struts 2 应 用 程序 时 ,会 遇 到 各 种 各 样 的 错误 。 
为 保证 程序 顺利 执行 ,在 利用 myEclipse 开发 Struts 2 应 用 时 ,必须 注意 以 下 几 点 。 

(1) 确保 必需 的 Struts 2 的 类 库 复制 到 WebRoot\WEB-INF\lib 目录 中 。 

(2) Web. xml 应 该 放 在 WebRoot\WEB-INF 目录 下 ,并 且 正 确 配置 核心 控制 器 。 
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(3) 表单 中 各 个 input 标签 的 name 取 值 必须 和 Action 类 中 属性 的 名 字 完 全 一 致 ， 
并 且 为 Action 类 中 的 每 个 属性 都 编写 了 Get 和 Set 方法 。 

(4) 如 果 结 果 视 图 (. jsp 文件 ) 中 需要 显示 Action 中 的 属性 值 , 则 必须 保证 结果 视图 
中 所 用 属性 名 和 Action 类 中 一 致 。 

(5) struts. xml 应 该 放 在 src 目录 下 ,正确 配置 Action 和 Action 对 应 的 类 、 结 果 类 
型 和 结果 映射 视图 。 

(6) struts 2-2. 3. 4-all. zip 的 示例 文档 中 有 一 个 struts 2-blank-2. 3. 4. war, 将 其 解压 
之 后 得 到 空 的 Struts 2 工程 。 初 学 者 可 以 从 该 工程 中 将 所 需 的 jar 类 库 、web. xml 和 
struts. xml 复制 到 自己 的 工程 中 。 


422 扩展 AcionSupport 类 


Action 类 是 Struts 2 的 核心 内 容 。 应 用 程序 能 够 完成 的 每 一 个 功能 都 对 应 Action 
或 者 Action 中 的 一 个 方法 。 客 户 端 通过 表单 或 者 URL 参数 提交 的 数据 被 Struts 2 传递 
给 了 Action 对 象 ,同时 在 Struts 2 处 理 Action 结果 映射 时 ,将 Action 对 象 中 的 属性 值 响 
应 给 用 户 。 

创建 Action 类 是 Struts 2 中 最 重要 的 任务 。Action 类 就 是 一 个 普通 的 POJO 类 ,每 
个 属性 都 需要 编写 get 方法 (向 Action 对 象 的 属性 传 值 时 调用 ) 和 set 方法 (Action 对 象 
向 JSP 页 面 或 其 他 Action 传 值 时 调用 ) 。 

每 个 Action 类 必须 包含 一 个 无 参 的 构造 函数 。 正 常情 况 下 ,一 个 Java 类 如 果 没 有 
编写 任何 构造 函数 ,编译 程序 会 自动 生成 一 个 无 参 的 构造 函数 。 如 果 编 写 了 带 有 参数 的 
构造 函数 ,就 必须 编写 一 个 无 参 的 构造 函数 (即使 这 个 函数 什么 也 不 做 ) 。 

每 个 Action 类 至 少 提 供 一 个 public 类 型 的 方法 供 Struts 2 在 执行 Action 时 调用 ， 
该 方法 的 返回 类 型 必须 为 String 类 型 。 默 认 时 ,Struts 2 会 自动 调用 execute() 方 法 。 

在 代码 4-2 中 ,利用 一 个 普通 的 POJO 类 充当 了 留言 板 登 录 程 序 的 Action 处 理 类 。 
在 Struts 2 的 开发 包 中 提供 了 一 个 com. opensymphony. xwork2. Action 接口 。 代 码 4-6 
给 出 了 Action 接口 的 源 代 码 。 接 口中 定义 了 一 个 默认 的 业务 逻辑 方法 execute() 和 五 个 
常量 ,这 五 个 常量 就 是 在 日 常 开发 中 业务 逻辑 方法 返回 的 字符 串 。 程 序 员 在 编写 Action 
类 时 可 以 直接 实现 Action 接口 ,但 更 多 的 是 扩展 Action 接口 的 实现 类 com. 


opensymphony. xwork2. ActionSupport 。 


代码 4-6 ”Action 接口 


Piblic interface Action { 
Eublic static final String SUOCESS= "sucoess"; 
piblic static final String NONE= "none™; 
Public static final String FRROR= "error"; 
piblic static final String INPUI= "input"; 
piblic static final String IOSIN= "login"; 
public String execute () throws Exosption; 
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ActionSupport 类 在 实现 Action 接口 的 同时 ,实现 了 ValidationAware 和 LocaleProvider 
等 。 扩 展 ActionSupport 类 ,Action 类 能 够 很 方便 地 完成 数据 验证 .国际 化 等 工作 。 代 
码 4-7 通过 扩展 ActionSupport 类 给 出 了 代码 4-2 的 另 一 个 版 本 LoginAction2. java。 


代码 4-7 LoginAction2. java 


package exanple.action; 
import om.cpensyrphony.xwork?.ActionSupport; 
Public class LoginAction? extends ActicnSupport { 


private String userName; // 定 义 登录 名 称 属性 
private String password; // 定 义 登录 密码 属性 
/* 省 略 了 get 和 set 方 法 的 代码 ,请 读者 自行 添加 * / 
Public String execute () { // 登 录 验 证 
证 ("zhangsan".equals (userName) ££"123".equals password)) 
retum SUCESS; // 登 录 成 功 返 回 sucoess 
else 
retum IOGIN; // 登 录 失 败 返回 login 


3 


注意 : 由 于 ActionSupport 是 Action 接口 的 实现 类 ,因此 代码 4-7 中 可 以 直接 使 用 
SUCCESS 和 LOGIN 等 结果 代码 。 


43 接收 用 户 输 入 


在 开发 Web 应 用 程序 的 过 程 中 ,不 可 避免 地 会 遇 到 处 理 用 户 输入 数据 的 问题 。 
Struts 2 提供 了 几 种 方法 ,使 用 户 能 够 很 方便 地 将 请 求 参数 绑 定 到 Action 属性 中 。 


431 属性 驱动 


在 Struts 2 中 ,可 以 直接 使 用 Action 的 属性 来 接收 用 户 的 输入 。 代 码 4-8 给 出 了 一 
个 用 于 信息 维护 的 页 面 userInfor. jsp。 表 单 中 包含 一 个 文本 框 userName, 两 个 单 选 按钮 
gender 和 三 个 复 选 框 favorite。 注 意 ,处 理 表 单 的 Action 属性 的 值 为 userAction. action? 
id 一 1, 包 含 了 一 个 请 求 参数 url。 


代码 4-8 userInfor. jsp 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 

<html> 

<head><title> 个 人 信息 维护 < /title>< /head> 

<body> 
< form namer "regFom" acticn= "userAction.acticn?ide 1" method- "post"> 
用 户 名 : 

< imput typer "text" maxlengthr "20" size= "40" name= userName" /><br/> 

性 别 : 
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女 <input type= "radio" name= "gender" value= mn" /> 
男 < input type= "radio" name= "gender" value= "2" checked /><br/> 
喜好 的 运动 : 
< input type= "checkbox" name "favorite" value- "篮球 " checked 人 > 篮球 
< input typer "checkbox" name= "favorite" value= 呢 球 " /> 足球 
< input type= "checkbox" name= "favorite" value= " 叭 山 " /> 扑 山 <br/> 
< input type= "submit" value= "确认 " /> 
< input type= "reset" value= " 重 置 " /> 
< /fom> 
< /body> 
</htm> 


下 面 编写 一 个 Action 类 UserAction. java, 用 于 接收 代码 4-8 给 出 的 页 面 的 提交 
数据 。 

注意 : 当 采 用 Action 属性 接收 输入 时 , Action 类 中 必须 定义 与 url 参数 名 以 及 
Input 标签 的 name 同名 的 属性 ,并 为 每 个 属性 定义 set 方法 。 对 于 表单 中 的 favorite, 由 
于 对 应 一 组 输入 值 , 在 Action 类 中 需要 使 用 List 或 数组 来 接收 。 出 于 演示 的 目的 ， 
UserAction. java 在 接收 到 用 户 输入 后 ,直接 将 数据 打印 到 控制 台 上 。 

UserAction. java 的 内 容 如 代码 4-9 所 示 。 这 里 采用 List 接收 一 组 checkbox 的 
输入 。 


代码 4-9 UserAction. java 


Package exarple.action; 
import java.util.Tterator; 
import java.util .List; 
jimport om.opensyrphony .xwork?2.ActionSupport; 
Public class UserAction extends ActionSupport { 
Private String userName; 
Private int gender; 
private List< String> favorite; // 用 于 接收 checkbox 的 值 


private int id; // 用 于 接收 url 请 求 参数 ia 的 值 
// 省 略 了 userName,gender, favorite 和 id 的 get 和 set 方 法 
/= 


Public String execute () throws Exosption { 
System.out .print ln ("userName= "+ userName) ; 
System.out .print ln ("gender= "+ gender); 
System.out .print In ("id= "+ iqd); 

System.out .print ("favorite="); 
Iterator< String> it= favorite. iterator(); 
while (it.hasNext ()) { 
System.out.Print (it.next ()+ " "); 
} 
retum SUOCESS; 
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注意 : UserAction. java 中 的 属性 gender 和 id 的 类 型 为 int。 在 基于 HTTP 的 协议 
中 ,客户 端 和 服务 器 之 间 传 输 的 数据 都 是 字符 串 数据 。Struts 2 提供 了 自动 类 型 转换 功 
能 ,能 够 将 客户 端 传送 来 的 数据 自动 转化 为 正确 的 类 型 。 这 一 部 分 内 容 将 在 后 面 的 章节 
中 讲述 。 

在 Struts 2 接收 到 表单 提交 请 求 后 ,会 自动 调用 UseAction 对 象 的 各 个 set 方法 ,将 
输入 数据 绑 定 到 同名 的 属性 上 。 


432 模型 驱动 


尽管 利用 Action 属性 能 够 完成 对 用 户 输入 数据 的 接收 ,但 是 在 实际 的 开发 中 ,往往 
会 把 用 户 输入 的 信息 封装 在 一 个 Model 中 ,此 时 需要 使 用 领域 模型 来 接收 用 户 输入 。 
代码 4-10 为 经 过 改写 的 用 户 登 录 页 面 的 代码 ,请 注意 input 标签 的 取 值 。 


代码 4-10 ”登录 表单 


< $@ page language= "java" FagsEncodingr- "UTF- 8"%> 
<htm> 
<head> <title> 登 录 < /title> < /head> 
<body> 
<h2> 请 您 登录 < /h2> 
< form name= "foml action= "login3.action" method= "post"> 
用 户 名 : < input type= "text" name= "user.userNeme"> <br> 
口令 : < input type= "password" name= "user.password"> <br> 
<input type= "aitmit" value= "提交 吃 
< :input type= "reset" value= " 重 置 吃 
< /fom> 
< /body> 
< /html> 


代码 4-11 中 定义 了 一 个 JavaBean 类 User. java, 然 后 在 LoginAction3. java 中 利用 
一 个 User 对 象 user 处 理 用 户 输入 。 
代码 4-11 利用 领域 对 象 接收 用 户 输入 数据 


Pex% User.java *x#/ 


Package exanple.Model; 

Piblic class User { 
private String usernamey // 用 户 名 
Private String password; /密码 


// 省 略 了 usemame、password 属 性 的 gat 和 set 方 法 
} 


rx% Ioginactian3.java xxx/ 
Package exarple.action; 
import exarple.Model .User; 
import om.opensynphony .xwork2.Action; 
Puiblic class Ioginnction3 implements Rcticn { 
Private User user; // 定 义 领域 对 象 user 
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Public void setUser (User user) { 
this.user= user; 
} 
piblic String execute() throws Exoepticn { 
证 ("zhangsan" .equals (user.getUserName ()) 
&&"123".equals (user .getPassword())) 
retum SUOCESS; // 登 录 成 功 返 回 suocEss 
else 
retum IOGIN; // 登 录 失 败 返回 IoGIN 


} 


在 这 个 例子 中 ,表单 中 包括 了 两 个 name 属性 的 取 值 分 别 为 user. userName 和 user. 
password 的 input 标签 。 这 里 的 user 与 LoginAction3. java 中 的 领域 属性 同名 ， 
username 和 password 是 领域 属性 user 的 属性 名 。 根 据 Struts 2 的 数据 绑 定 机 制 , 在 向 
Action 传递 数据 时 ,user. userName 等 同 于 调用 getUser(). setUserName() 。 

请 注意 ,LoginAction3. java 中 的 user 在 定义 后 并 没有 实例 化 ,但 在 执行 语句 


"zhangsan" .equals (user .getUserName ()) 


象 特性 。 当 Struts 2 发 现 User 对 象 为 空 时 ,会 自动 调用 User 类 的 无 参 构造 函数 构造 一 
个 User 实例 。 


433 实现 MbdaDriven 

在 4.3.2 小 节 给 出 的 利用 领域 对 象 接收 用 户 输入 数据 的 方法 中 ,要 求 JSP 页 面 中 
input 标签 的 name 属性 必须 使 用 “领域 对 象 名 . 属性 名 ”的 格式 命名 。Struts 2 提供 了 另 
外 一 种 模型 驱动 的 方法 , 即 让 Action 类 实现 com. opensymphony. xwork2. ModelDriven 
接口 ,该 接口 中 只 定义 了 一 个 方法 。 

Public T getMpdel () 


使 用 getModel() 方 法 来 通知 Struts 2 要 绑 定 的 属性 类 型 。 与 4. 3. 2 小 节 给 出 的 模 
型 驱动 方法 不 同 的 是 ,领域 对 象 在 声明 时 一 定 要 实例 化 ,但 是 不 需要 提供 get 方法 和 set 
方法 。 代 码 4-12 为 实现 了 ModelDriven 的 Action 类 。 


代码 4-12 实现 了 ModelDriven 的 Action 类 


package exanple.action; 

import exanple.Model .User; 

jimport om.cpensynphony .xwork?.ActionSupport; 
import om.cpensyrphony.xwork?.ModelDriven; 
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implements ModelDriven< User> { 
Private User user= new User (); //user 一 定 要 实例 化 
puiblic String execute() throws Fxospticn { 
if ("zhangsan".equals (user.getUserName ()) 
&& "123".eqguals (user.getPassword())) { 
retum SUOCESS; // 登 录 成 功 返 回 suocEss 


retum IDGIN; // 登 录 失败 返回 IoGIN 


在 实现 了 ModelDriven 接口 之 后 ,输入 表单 中 input 标签 的 name 命名 时 就 不 必 加 上 
user 前 级 了 ,只 需要 与 User 类 的 userName 和 password 属性 同名 即 可 ,具体 代码 可 以 参 
见 代码 4-3。 

Struts 2 之 所 以 能 够 完成 输入 请 求 和 Action 类 之 间 的 数据 绑 定 ,完全 是 依靠 
params、prepare 和 ModelDriven 拦截 器 发 挥 的 作用 。 关 于 拦截 器 ,将 在 后 面 的 章节 中 
讲述 。 


44 跟踪 用 户 状 态 


在 纯 JSP 编程 时 ,利用 request ,application 和 session 等 内 置 对 象 可 以 获得 用 户 的 请 
求 信 息 , 实 现 用 户 响 应 和 完成 会 话 跟踪 等 工作 。 在 Servlet 编程 时 ,也 可 以 通过 
HttpServletRequest、 HttpSession 和 ServletContext 等 完成 同样 的 工作 。 尽 管 利用 
Struts 2 框架 提供 的 数据 绑 定 等 功能 能 够 方便 地 完成 上 述 用 户 请 求 和 响应 处 理 , 但 在 有 
些 情况 下 仍然 需要 在 Action 中 访问 上 述 几 种 Servlet 对 象 。 例 如 , 当 一 个 用 户 登 录 成 功 
后 ,需要 将 用 户 信息 添加 到 session 中 。 


441 利用 非 IoC 方 式 跟踪 用 户 状态 


IoC(Inversion of Control ,控制 反 转 ?就 是 将 应 用 系统 中 原来 由 程序 控制 “对 象 之 间 
的 关系 ”转交 给 由 外 部 容器 来 实现 控制 。 利 用 非 IoC 方式 跟踪 用 户 状态 ,就 是 采用 直接 
编写 程序 代码 的 方式 控制 生成 与 状态 跟踪 有 关 的 对 象 实例 。 

Struts 2 提供 了 两 种 方法 实现 利用 非 IoC 方式 跟踪 用 户 状态 : 一 种 方法 是 利用 
ActionContext; 另 一 种 方法 是 利用 ServletActionContext。 

1 AcionCorted 

ActionContext 是 一 个 容器 ,主要 存储 request, session、application 和 parameters 等 与 
Action 执行 有 关 的 上 下 文 信息 。 在 每 次 执行 Action 之 前 都 会 创建 新 的 ActionContext。 
ActionContext 是 线程 安全 的 ,也 就 是 说 ,在 同一 个 线程 里 ,ActionContext 里 的 属性 是 唯一 
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的 。 这 样 , 用 户 的 Action 可 以 在 多 线程 中 使 用 。 

ActionContext 类 定义 了 一 系列 方法 ,用 于 访问 封装 了 HttpServletRequest、 
HttpServletResponse、HttpSession 和 ServletContext 等 信息 的 Map 对 象 。 

(1) public Map<String，Object>getSession() : 返回 一 个 Map 对 象 。 该 对 象 模拟 
了 HttpSession 实例 。 

(2) public void setSession(Map 一 String，Object 二 session) : 设置 session 。 

(3) public Map< 一 String，ObjectgetApplication(): 返回 一 个 Map 对 象 。 该 对 象 
模拟 了 ServletContext 实例 。 

(4) public void setApplication(Map 一 String， Object 二 application) : 设置 Action 的 
application 上 下 文 。 

(5) public Map 一 String，Object 二 getParameters(): 返回 一 个 Map 对 象 。 该 对 象 
封装 了 所 有 HttpServletRequest 请 求 参 数 。 

(6) public Object get(String key): 从 ActionContext 中 取出 一 个 值 , 类 似 于 调用 
HttpServletRequest 的 getParameter() 方 法 。 当 key 的 值 取 request 时 ,相当 于 取出 一 个 
HttpServletRequest 实例 。 

从 ActionContext 提供 的 方法 可 以 看 出 ,Struts 2 把 ServletContext 等 信息 封装 成 了 
一 个 个 Map 对 象 ,key 是 标识 request ,session 等 的 字符 串 , 值 是 其 对 应 的 对 象 。 

ActionContext 是 一 个 线程 的 本 地 变量 ,这 意味 着 ,不 同 的 Action 之 间 不 会 共享 
ActionContext, 所 以 也 不 用 考虑 线程 安全 问题 。 

接 下 来 ,改写 代码 4-2 中 给 出 的 用 户 登录 Action, 利 用 ActionContext 增加 对 用 户 状 
态 的 跟踪 ,如 代码 4-13 所 示 。 


代码 4-13 ”LoginAction. jsp( 利 用 ActionContext 访问 request 等 ) 


Package exanple.action; 
import java.util .Map; 
jimport om.opensymrphony .xwork2.ActionContext; 
jimport om.opensymphony .xwork2.ActionSupport; 
Public class LoginAction extends Actionsupport { 
Private String userName; 
Private String password; 
/* 省 略 了 getter 和 setter 方 法 的 代码 ,请 读者 自行 添加 * / 


Public String execute() { 
ReticnContext oontext= ActionContext .getOontext (); 
Map session= ontext .getSession () 7 
3ession.put ("user", userName); 


Map request= (Map) context.get ("request"); 
request.put ("weloome", "您 好 ,欢迎 登录 系统 1"); 


Map application= omtext .getapplication(); 
Integer nt= (Integer)application.gat ("count"); 
证 oull==cnt) 
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Cnt+ 十 7 
application.put ("oount", ant); 
retum SUOCESS; 


} 


LoginAction 类 的 成 功 页 面 将 映射 到 welcome. jsp, 将 利用 Struts 2 提供 的 property 
标签 将 保存 在 session ,request 和 application 中 的 数据 取出 来 。 有 关 Struts 2 标签 的 知 
识 ,将 在 后 续 章 节 中 讲述 。welcome. jsp 的 内 容 如 代码 4-14 所 示 。 


代码 4-14 welcome. jsp 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 
< %@ taglib uri= "/struts- tags" prefix= "s" $> 
<html> 
<head> 
<title> 登 录 成 功 < /title> 
< /head> 
<body> 
<ul> 
<1li> 
下 面 的 zhangsan 是 利用 action 属 性 传递 过 来 的 
< h2> < s:property value= "userName"/> 
< s:property value= "# request.welome"/>< /h2> 
</li> 
<1i> 
下 面 的 zhangsan 是 利用 reqoest 对 象 传递 过 来 的 
<h2> < s:property value= 只 request.userName"/> ,您 是 第 
< s:property value= 啡 application.count"/> 个 访问 者 。< /h2> 
</1i> 
<1i> 


下 面 的 zhangsan 是 利用 session 对 象 传递 过 来 的 
<h2> < s:property value= 叶 session.user"/> ,欢迎 您 !< /h2> 
</li> 
</al> 
< /body> 
</htm> 


测试 修改 之 后 的 留言 板 登录 程序 。 图 4-2 给 出 了 成 功 登 录 后 的 页 面 。welcome. jsp 
显示 了 三 次 zhangsan: 第 一 个 zhangsan 是 通过 绑 定 LoginAction 类 的 属性 userName 得 
到 的 ;第 二 个 zhangsan 是 利用 request 对 象 获取 的 ,由 于 在 ActionContext 中 封装 了 一 个 
HttpServletRequest 的 Map 对 象 , 所 有 绑 定 到 Action 类 的 属性 的 数据 同样 会 传递 给 该 
Map 对 象 ;第 三 个 zhangsan 显示 的 是 保存 在 session 中 的 数据 。 

需要 注意 的 是 ,最 好 不 要 在 Action 类 的 构造 函数 中 访问 ActionContext, 因 为 此 时 部 
分 数据 尚未 准备 完成 。 
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€ 3 CC | O127.0.0.1:8080/notes/login.action 容 | 色 
。 下 面 的 zhangsan 是 利用 action 属 性 传递 过 来 的 


zhangsan 您 好 ， 欢 迎 登 录 系 统 ! 


。 下 面 的 zhangsan 是 保存 在 request 中 的 
zhangsan, 您 是 第 10 个 访问 者 。 

。 下 面 的 zhangsan 是 保存 在 session 中 的 
zhangsan, 欢迎 您 ! 


4-2 ” welcome. jsp 运行 界面 


2 SevetAcionConted 

类 org. apache. Struts 2. ServletActionContext 继承 了 ActionContext 类 , 它 提供 了 
直接 对 Servlet 相关 对 象 访问 的 功能 。 利 用 ServletActionContext 可 以 直接 访问 如 下 
Servlet 的 对 象 。 


(1) javax. 
(2) javax. 
(3) javax. 
(4) javax. 


(5) javax. 


servlet. http. HttpServletRequest: HttpServlet 请 求 对 象 。 
servlet. http. HttpServletResponse: HttpServlet 相应 对 象 。 
servlet. ServletContext: Servlet 上 下 文 环境 。 

servlet. ServletConfig: Servlet 配置 对 象 。 

servlet. jsp. PageContext: HTTP 页 面 上 下 文 。 


程序 员 可 以 利用 ServletActionContext 类 提供 的 静态 方法 获得 与 用 户 跟踪 相关 的 


Servlet 对 象 。 


(1) 获得 ServletContext 对 象 : 


HttpServletContext context= ServletActionContext. getServletContext (); 


JSP 中 的 application 内 置 对 象 是 javax. servlet. ServletContext 接口 的 一 个 实例 , 因 
此 这 里 的 context 就 相当 于 前 面 学 过 的 application 对 象 ,程序 员 可 以 直接 利用 context 通 
过 getAttribute() 方 法 和 setAttribute() 方 法 访问 需要 在 Application 一 级 保存 的 数据 。 
(2) 获得 HttpServletRequest 对 象 : 


HttpServletRequest request=— ServletActionContext. getRequest (); 
(3) 获得 HttpSession 对 象 : 


HttpSession session= ServletActionContext. getRequest () .getSession(); 
类 ServletActionContext 没有 提供 直接 获得 HttpSession 对 象 的 方法 , HttpSession 


对 象 可 以 通过 HttpServletRequest 对 象 来 获得 。 
请 读者 自行 利用 ServletActionContext 类 改写 本 节 中 的 程序 。 
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442 利用 IoC 方 式 跟踪 用 户 状态 


所 谓 利 用 IoC 方式 跟踪 用 户 状态 ,是 指 程序 员 不 必 在 Action 类 中 通过 ActionContext 
类 或 ServletActionContext 类 手工 获取 与 request 或 是 session 有 关 的 Map 对 象 或 Servlet 
实例 ,而 是 让 Struts 2 框架 在 运行 时 向 Action 中 注入 session request 和 application 。 

与 非 IoC 方式 类 似 ,Struts 2 也 提供 了 两 种 Servlet 对 象 注入 方式 : 一 种 是 注入 包装 
成 Map 对 的 Servlet; 另 一 种 方式 是 注入 真实 的 Servlet 对 象 。 

Struts 2 提供 了 三 个 接口 用 于 访问 session ,request 和 application 。 

(1) org. apache. struts2. interceptor. SessionAware。Struts 2 利用 该 接口 向 Action 
实例 注入 session 的 Map 对 象 。 实 现 该 接口 时 ,必须 实现 如 下 方法 : 

Public void setSession (Map< String, Cbject> sessicn) 

(2) org. apache. struts2. interceptor. RequestAware。Struts 2 利用 该 接口 向 Action 
实例 注入 request 的 Map 对 象 。 实 现 该 接口 时 ,必须 实现 如 下 方法 : 

Public void setRequest (Map< String, Cbject> request) 

(3) org. apache. struts2. interceptor. ApplicationAware。Struts 2 利用 该 接口 ,向 
Action 实例 注入 application 的 Map 对 象 。 实 现 该 接口 时 ,必须 实现 如 下 方法 : 

Public void setApplication (Map< String,Object> application) 

在 代码 4-15 中 ,LoginAction 类 通过 实现 上 述 三 个 接口 来 跟踪 用 户 状态 。 


代码 4-15 ”LoginAction. java( 实 现 SessionAware 等 接口 ) 


Package exarple.action; 
import java.util .Map; 


jimport org.apache.struts2.interosptor.ApplicationAware; 
jimport org.apache.struts2.interosptor.RequestAware; 
jimport org.apache.struts2.interosptor.SessionAware; 
jimport om.cpensyrphony .xwork?2.ActionSupport; 


Public class LoginAction extends ActionSupport 
jmplements SessionAware,RequestAware, ArPlicaticonAware { 
Private String userName; 
Private String password; 
Private Mep sessicn; 
Private Mep request; 
Private Map earplicaticn; 


/* 省 略 了 getter 和 setter 方 法 的 代码 ,请 读者 自行 添加 * / 


Public void setSessicn (Map sessicn) { 
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public String execute() { 
Session.put ("user", userName); 
recquest .put (welcome" "您 好 ,欢迎 登录 系统 !"); 


Integer cnt= (Integer)application.get ("count"); 
if(null==ont) 
cnt= 17 
else 
cnt++ 
apPlication.put(" ", nt); 


retum SUOCESS; 


} 


成 功 返 回 页 面 与 4.4 节 中 是 一 样 的 ,这 里 不 再 缆 述 。 

如 果 和 希望 Struts 2 框架 在 Action 实例 运行 时 注入 真实 的 Servlet 对 象 ,需要 让 
Action 类 实现 如 下 接口 。 

(1) org. apache. struts2. interceptor. ServletRequestAware。Struts 2 框架 利用 该 接 
口 向 Action 类 注入 HttpServletRequest 对 象 。 实 现 该 接口 时 ,需要 实现 如 下 方法 : 

Void setServletRequest (HttpServletRequest reguest) 

(2) org. apache. struts2. interceptor. ServletContextAware。Struts 2 框架 利用 该 接 
口 向 Action 类 注入 ServletContext 对 象 。 实 现 该 接口 时 ,需要 实现 如 下 方法 : 

Void setServletContext (ServletContext ontext) 


请 读者 自行 利用 上 述 两 个 接口 改写 代码 4-14。 
45 MEcipse 提供 的 Sruts 2 添加 向 导 
在 开发 基于 Struts 2 的 Web 应 用 程序 时 ,需要 为 应 用 程序 添加 Struts 2 的 支持 包 ， 


在 Struts 2 中 配置 核心 过 滤器 ,配置 Struts. xml 文件 ,这 些 工作 除了 手工 完成 外 ,可 以 使 
用 MyEclipse 提供 的 Add Struts Capabilities 向 导 来 进行 。 
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依次 执行 MyEclipse->Project Capabilities->Add Struts Capabilities 菜单 命令 ,打开 
添加 Struts 支持 向 导 Add Struts Capabilities, 如 图 4-3 所 示 。 


$ Add Struts Capabilities =I9|x| 
Struts Support for MyEclipse Web Project er 
Enable project for Struts development © 


Struts specfication: Struts1.1 Struts1.2 三 Smuts13 三 Suuts241 


Struts 2 fer name: [Ftruts2 
URLpaktem meaton Crd Ce 


加 ci | ees | ] cr 


图 4-3 Add Struts Capabilities 向 导 


在 Add Struts Capabilities 向 导 中 ,可 以 通过 Struts specification 选项 组 选择 需要 添 
加 的 Struts 2 版 本 。 由 于 开发 时 使 用 的 是 Struts 2 框架 ,因此 选择 Struts 2. 1 选项 。 利 
用 URL pattern 选项 组 选择 需要 交 由 Struts 2 处 理 的 服务 请 求 的 类 型 ,其 中 各 选项 含义 
如 下 。 

(1) * .action: 仅 将 所 有 扩展 名 为 . action 的 URL 请 求 交 给 Struts 2 处 理 。 

(2) * .do: 仅 将 所 有 扩展 名 为 . do 的 URL 请 求 交 给 Struts 2 处 理 , 这 是 模拟 Struts 
1. x 框架 中 的 请 求 URL。 

(3) /x* : 所 有 服务 请 求 均 交 给 Struts 2 处 理 。 

单 击 Next 按钮 ,进入 下 一 步 , 为 应 用 程序 添加 Struts 2 支持 库 和 自 定义 的 类 库 , 如 
图 4-4 所 示 。 上 默认 时 ,MyEclipse 仅 为 应 用 程序 添加 Struts 2 的 核心 库 。 用 户 可 以 根据 需 
要 添加 Struts 2 DOJO 等 类 库 。 


Add Struts Capabilities 二 对 
Struts 2 Libraries Er 
Add Struts 2 and User Ubrariesto the project Oy 
Select the lbraries to add to project buldpath 

Show; 7 MyEcipse Lbraries User Lbraries 


View and edit lbraries. 
名 Ce we Iew ] com | 


4-4 添加 Struts 2 支持 库 


默认 情况 下 ,MyEclipse 将 为 应 用 程序 添加 四 十 几 个 JAR 包 , 其 中 有 很 多 包 在 用 户 
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程序 中 可 能 用 不 到 。 为 此 ,用 户 可 以 选择 Struts 2 Core Libraries, 然 后 单 击 View and 
edit libraries... 链 接 , 在 打开 的 Preferences(filtered) 对 话 框 中 删除 不 必要 的 JAR 文件 。 在 
Preferences(filtered) 对 话 框 中 选择 Struts 2 后 ,可 以 看 到 MyEclipse 为 应 用 程序 添加 的 与 所 
有 Struts 2 有 关 的 JAR 文 件 ,如 图 4-5 所 示 。 仅 保留 第 4 章 中 介绍 的 前 6 个 即 可 。 


Boe eer te 


互 


图 4-5 ”Preferences(filtered) 对 话 框 


注意 : 利用 MyEclipse 的 Struts 2 支持 向 导 添 加 的 Struts 2 版 本 是 Struts-2.1.8.1， 
不 需要 Javassist-x. x. ga. jar。 

回 到 Add Struts Capabilities 对 话 框 ,然后 单 击 Finish 按钮 ,完成 添加 Struts 2 支 
持 。 此 时 , 单 击 包 浏览 器 Package Explorer, 可 以 看 到 上 述 操作 过 程 的 结果 。 

(1) Struts 2 支持 包 已 经 添加 到 应 用 程序 中 。 

(2) 在 src 文件 夹 下 添加 了 一 个 struts. xml 配置 文件 。 

(3) 打开 web. xml, 可 以 看 到 Struts 2 的 核心 过 滤器 配置 完成 。 

最 后 ,需要 提醒 的 是 ,利用 向 导 添 加 的 Struts 2 支持 包 来 源 于 MyEclipse 安装 目录 ， 
版 本 相对 比较 老 , 如 果 读者 希望 使 用 相对 较 新 的 开发 包 , 则 建议 手工 配置 。 


同步 训练 


1. 为 留言 板 程序 编写 Action 类 。 
2. 编写 站 内 短信 系统 的 Action 类 。 


hapter 5 
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51 Struts 2 的 工作 原理 


在 体验 完 利 用 Struts 2 开发 Web 应 用 程序 的 过 程 之 后 ,我 们 来 看 一 下 Struts 2 的 工 
作 原 理 。 

Struts 2 框架 是 在 Struts 1 和 WebWork 基础 上 发 展 而 来 ,在 实际 的 Web 应 用 开发 
过 程 中 ,主要 用 于 解决 与 表示 层 的 相关 问题 。Struts 2 的 核心 架构 是 基于 MVC 设计 模 
式 设计 ,Model 由 程序 员 编 写 的 一 系列 Action 以 及 一 些 用 于 实现 业务 逻辑 方法 或 与 底层 
数据 库 交 互 的 实体 类 组 成 ; View 通常 是 指 JSP 页 面 或 者 其 他 视图 显示 技术 , 如 
FreeMarker 或 者 Velocity 等 ;Control 是 Struts 2 框架 提供 的 FilterDispatcher( 现 在 已 由 
StrutsPrepareAndExecuteFilter 取代 ) 核 心 控制 器 ,负责 根据 客户 请 求 调用 相应 的 模型 组 
件 Action, 再 由 Action 调用 相应 的 业务 逻辑 组 件 来 完成 处 理 。 

图 5-1 是 Struts 2 官方 文档 中 给 出 的 Struts 2 体系 结构 图 。 

Struts 2 体系 结构 中 包括 的 部 件 比 较 多 ,主要 有 以 下 几 项 。 

(1) ActionMapper: 用 于 提供 HTTP 请 求 与 Action 执行 之 间 的 映射 。 当 请 求 到 达 
时 ,ActionMapper 根据 web. xml 中 核心 控制 器 的 配置 判断 是 否 应 该 由 Struts 2 框架 处 
理 该 请 求 。 如 果 应 该 处 理 , 则 ActionMapper 返回 一 个 对 象 来 描述 请 求 对 应 的 
ActionInvocation 的 信息 。 

(2) FilterDispatcher: 已 经 由 StrutsPrepareAndExecuteFilter 替代 ,是 Struts 2 的 调 
度 中 心 ,在 获得 ActionMapper 的 处 理 通 知 后 ,负责 停止 过 滤器 链 上 还 没有 执行 的 过 滤 
器 ,执行 Action 处 理 。 

(3) ActionProxy: 充当 了 Action 和 xwork 之 间 的 代理 ,负责 初始 化 Action 运行 所 
需 的 所 有 参数 配置 等 。ActionProxy 持 有 ActionInvocation 对 象 。 

(4) ConfigurationManager: 提供 对 配置 文件 struts. xml 的 访问 。 该 对 象 在 Web 应 
用 程序 开始 运行 时 ,将 struts. xml 读 和 人 内存。 

(5) struts. xml: Struts 2 的 应 用 配置 文件 ,负责 配置 请 求 与 Action 之 间 的 映射 ,以 
及 配置 Action 结果 码 对 应 的 Result 视图 等 。 

(6) ActionInvocation: 负责 调度 Interceptor、Action 和 Result。 

(7) Interceptor( 拦 截 器 ) : 拦截 器 类 似 于 Servlet 中 的 过 滤器 ,提供 了 在 Action 运行 
之 前 或 Result 运行 之 后 执行 一 些 功 能 代码 的 机 会 。 


第 5 章 深入 Struts 2 < 


ActionContextCleanUp | 


Other filters(SiteMesh,etc.) D 


FilterDispatcher 


ActionProxy 
~ 
Tag Subsystem 


figurati HTML,Dojo, 
configuration 
Memeet Action forms,etc. 


Invocation 


HttpServletResponse 


Servlet Filters 口 Struts Core 团 Interceptors 团 User created 


图 5-1 Struts 2 的 体系 结构 


(8) Action: 负责 处 理 用 户 请 求 , 调 用 业务 迎 辑 组 件 。 

(9) Result: 负责 映射 Action 执行 后 需要 呈献 给 客户 端的 结果 视图 ,可 以 是 一 个 
JSP 页 面 或 是 某 个 Action。 

(10) Templates: 各 种 视图 类 型 的 页 面 模板 。Struts 2 集成 了 三 种 模板 : JSP、 
FreeMarker 和 Velocity 。 

(11) Tag Subsystem( 标 签 库 ) : Struts 2 的 标签 库 。 

(12) ActionContextCleanUp: 在 集成 SiteMesh 或 者 其 他 过 滤器 时 ,需要 在 Web. Xml 中 
配置 这 个 部 件 ,推迟 核心 控制 器 对 ActionContext 的 清空 ,以 便 集成 的 过 滤器 能 够 访问 到 
值 栈 中 的 数据 。 

下 面 结 合 4. 2 节 的 例子 来 研究 Struts 2 框架 的 请 求 处 理 流 程 。 

(1) 当 Servlet 容器 接收 到 客户 请 求 http://127. 0. 0.1:8080/login. action 后 ,首先 
将 请 求 交 给 FilterDispatcher 或 StrutsPrepareAndExecuteFilter 的 doFilter() 方 法 。 

(2) 核心 控制 器 的 doFilter() 方 法 询问 ActionMapper 是 否 应 该 由 Struts 2 框架 处 理 
login. action 。 

(3) ActionMapper 告诉 核心 控制 器 ,需要 处 理 login. action ,核心 控制 器 会 停止 过 滤 
器 链 以 后 的 部 分 (本 例 中 没有 ) 。 

(4) 核心 控制 器 调用 Dispatcher 类 的 serviceAction() 方 法 。 
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(5) Dispatcher 调用 ActionProxy 的 execute() 方 法 。 

(6) ActionProxy 对 象 利用 从 核心 控制 器 中 获得 的 请 求 的 URL 向 ConfigurationManager 
查询 Login. Action 对 应 的 实现 类 。 

(7) ActionProxy 创建 ActionInvocation 对 象 , 设 置 它 的 执行 上 下 文 ActionContext， 
并 调用 其 invoke() 方 法 。 从 这 一 步 也 可 以 看 出 ,第 4 章 所 说 的 ActionContext 是 线程 安 
全 的 ,原因 就 在 于 每 个 请 求 的 ActionInvocation 对 象 是 不 同 的 ,每 个 ActionInvocation 对 
象 有 自己 的 ActionContext, 所 以 不 同 的 Action 之 间 是 不 会 共享 ActionContext 的 。 

(8) ActionInvocation 对 象 的 invoke() 方 法 查找 所 有 未 执行 的 拦截 器 ,例如 params 拦截 
器 将 请 求 中 的 参数 userName 和 password 装配 到 LoginAction 实例 的 同名 属性 上 等 。 

(9) 在 所 有 拦截 器 执行 完毕 后 ,调用 LoginAction 实例 的 execute() 方 法 (在 其 他 应 
用 程序 中 可 能 是 其 他 方法 ,具体 取决 于 Action 的 配置 ) 。 

(10) ActionInvocation 对 象 按照 拦截 器 引用 顺序 的 倒序 依次 执行 各 个 拦截 器 的 后 置 
部 分 。 

(11) ActionInvocation 根据 LoginAction 实例 执行 返回 的 结果 码 (假设 为 success) ,查找 
struts. xml 中 对 应 的 result 映射 。 执 行 Result 的 execute() 方 法 从 ServletActionContext 中 
获得 HttpServletResponse 对 象 , 利 用 该 对 象 将 结果 页 面 /welcome. jsp 返回 给 浏览 器 。 
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521 Siuts 2 的 配置 文件 介绍 


每 个 Struts 2 应 用 程序 都 要 用 到 几 个 配置 文件 ,其 中 web. xml、struts. xml 和 
struts. properties 文件 是 最 基本 的 。web. xml 用 于 初始 化 Web 应 用 程序 的 配置 信息 , 例 
如 加 载 Struts 2 的 核心 控制 器 等 。struts. xml 文件 主要 负责 管理 Web 应 用 中 的 Action 
映射 ,以 及 该 Action 每 种 结果 代码 对 应 的 result 定义 等 。struts. properties 文件 主要 用 
于 配置 常量 。 

除了 上 述 3 个 配置 文件 外 ,Struts 2 的 配置 文件 还 包括 struts-default. xml 和 struts- 
plugin. xml。struts-default, xml 是 Struts 2 的 基础 配置 文件 ,定义 了 内 置 的 结果 类 型 . 拦 
截 器 和 拦截 器 栈 ,由 框架 自动 加 载 。struts-plugin. xml 用 于 为 Struts 2 添加 插件 
(plugin)。 通 过 插件 ,可 以 扩展 .替换 Struts 2 中 的 某 些 功能 点 ,也 可 以 加 入 自己 的 实现 
类 ,使 得 Struts 2 具备 新 的 功能 。 插 件 的 方式 也 使 得 任何 功能 扩展 都 与 Struts 2 的 主体 
程序 保持 独立 性 。 


522 ghusxm 的 结构 


struts. xml 文件 是 一 个 以 struts 作为 根 元 素 的 XML 文件 ,Struts 2 应 用 程序 的 很 多 
设置 都 需要 在 该 文件 中 完成 。 
在 struts. xml 可 以 完成 constant (常量 )、 package( 包 )、namespace( 命 名 空间 )、 
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include( 包 含 ) 、interceptor( 拦 截 器 )、action、result、exception( 异 常 ) 和 bean 配置 。 在 实 
际 的 开发 中 ,很 少 在 strust. xml 配置 bean , 感 兴趣 的 同学 可 以 自己 查找 相关 资料 ,本 书 不 
再 讨论 。 

523 constant( 常 量 ) 配 置 


org. apache. struts2 包 中 包含 了 一 个 default. properties 属性 文件 ,该 文件 定义 了 一 
系列 常量 ,这 些 常 量 给 出 了 Struts 2 应 用 运行 时 的 默认 配置 ,程序 员 可 以 通过 修改 这 些 常 
量 来 改变 相应 的 配置 。 

常量 的 修改 可 以 在 web. xml、struts. xml 和 struts. properties 文件 中 完成 。 通 常 ， 
Struts 2 框架 按照 如 下 搜索 顺序 加 载 Struts 2 常量 。 

(1) struts-default. xml 

(2 


(3) struts. xml 


struts-plugin. xml 


(4) struts. properties 

(5) web. xml 

也 就 是 说 ,如 果 在 多 个 文件 当中 配置 了 同一 个 Struts 2 常量 , 则 后 一 个 文件 中 配置 的 
常量 会 覆盖 前 面 文件 中 配置 的 常量 。 

下 面 给 出 在 Web 应 用 开发 过 程 中 常用 的 一 些 常量 ,读者 可 以 通过 default. properties 
文件 查看 所 有 的 常量 定义 。 

(1) struts. il8n. encoding。 用 于 指定 默认 的 编码 方案 ,默认 值 为 UTF-8。 

(2) struts. custom. il8n. resources。 用 于 指定 要 加 载 的 国际 化 资源 包 的 基 名 。 如 果 
包含 多 个 资源 包 , 则 需要 用 逗号 分 隔 。 

(3) struts. locale。 用 于 指定 Web 应 用 的 默认 Locale。 该 属性 未 设置 默认 值 。 

(4) struts. devMode。 用 于 指定 是 否 处 于 开发 模式 ,默认 值 为 false。 通 常 ,在 应 用 程 
序 开发 过 程 中 需要 将 该 常量 设置 为 true。 此 时 ,在 调试 过 程 中 ,Struts 2 框架 能 够 提供 更 
为 友好 的 错误 报告 方式 ,提醒 程序 员 更 多 的 错误 信息 。 

(5) struts. enable. DynamicMethodInvocation。 用 于 设置 是 否 支持 动态 方法 调用 ， 
默认 值 为 true。 出 于 安全 考虑 ,通常 要 将 该 常量 设置 为 false, 即 禁止 动态 方法 调用 。 


1 在 sruls properties 中 配置 常量 

struts. properties 文件 和 标准 的 Properties 文件 一 样 ,包含 了 一 系列 key-value 对 
象 , 每 个 key 就 是 一 个 Struts 2 属性 ,该 key 对 应 的 value 就 是 一 个 Struts 2 属性 值 。 程 
序 员 可 以 通过 在 struts. properties 文件 中 修改 default. properties 中 定义 的 属性 ,来 满足 
应 用 的 需求 。 

在 利用 MyEclipse 开发 Struts 2 应 用 时 ,struts. properties 应 该 放 在 src 目录 下 ， 
Web 应 用 发 布 时 会 自动 发 布 到 /WEB-INF/classes 目录 下 。 代 码 5-1 演示 了 如 何在 
struts. properties 中 配置 常量 。 
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代码 5-1 在 struts. properties 中 配置 常量 


Struts.devMpade= true 
struts.enable.DynamidMethodTnvocationr false 


2 在 srulsxnml 中 配置 常量 
也 可 以 在 struts. xml 中 利用 以 下 语句 配置 Struts 2 常量 。 


< constant name= mm value= "> < /constant> 
代码 5-2 演示 了 在 struts. xml 配置 Struts 2 常量 的 方法 ,其 效果 与 代码 5-1 等 价 。 
代码 5-2 在 struts. xml 配置 常量 


<struts> 
< constant neme= "struts.devMbden value= "true"> < /constant> 
< constant neme= "struts .enable.Dynemi cMathodIrvocation" value= "false"> 
< /constent> 


< /struts> 


常量 的 配置 通常 都 是 在 struts. xml 文件 中 进行 ,一 般 不 需要 在 struts. properties 文 
件 中 配置 Struts 2 常量 。Struts 2 框架 之 所 以 要 保留 struts. properties 文件 ,主要 是 为 了 
保持 与 WebWork 的 向 后 兼容 性 。 
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与 Java 语言 类 似 ,Struts 2 框架 也 使 用 包 来 管理 Action 和 拦截 器 等 。 每 个 包 就 是 一 
些 Action 拦截 器 ,resultrtypes 的 集合 。 使 用 package 可 以 对 Struts 2 的 配置 内 容 实 现 
模块 化 管理 ,每 个 package 中 存放 的 都 是 逻辑 上 相关 的 组 件 。 

Struts 2 中 的 package 类 似 于 Java 中 的 类 ,允许 从 一 个 package 的 基础 上 扩展 生成 
另 一 个 package。 

package 元 素 通常 需要 对 在 struts-default. xml 文件 里 定义 的 struts-default 包 进 行 
扩展 ,从 而 使 扩展 之 后 的 包 可 以 使 用 在 struts-default. xml 中 定义 的 结果 类 型 ,拦截 器 和 

package 元 素 的 形式 如 下 : 


< package name= "" extende= "" abstract= "" namespace= ""> 


< /package> 


其 中 ,每 个 package 元 素 必须 提供 一 个 name 属性 值 ,用 于 标识 包 的 名 字 。name 属 
性 的 取 值 必须 是 唯一 的 ,只 有 在 该 package 被 其 他 package 扩展 时 引用 。abstract 属性 允 
许 将 该 package 设置 为 抽象 的 。 抽 象 的 package 不 能 定义 Action。namespace 属性 用 于 
定义 package 的 命名 空间 ,将 在 下 一 节 讨论 。 

注意 : 子 包 中 配置 的 Action 和 拦截 器 引用 将 履 盖 父 包 中 配置 的 Action 和 拦截 器 引 
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525 nanespace (命名 空间 ) 配 置 


package 元 素 提 供 了 一 个 namespace 属性 。 通 过 namespace, 程 序 员 可 以 将 所 有 的 
Action 配置 划分 为 一 个 个 逻辑 单元 ,每 个 单元 都 有 它 自 己 的 标识 前 级, 从 而 避免 Action 
命名 的 冲突 。 在 访问 某 个 Action 时 ,通常 使 用 形 如 namespace/actionname 的 URI。 

package 元 素 的 默认 命名 空间 为 ""。Struts 2 框架 在 查找 Action 时 ,如 果 其 他 所 有 
的 namespace 中 都 找 不 到 的 时 候 , 就 会 到 这 个 namespace 中 寻找 。 

Struts 2 支持 根 namespace*/”。 对 于 包含 在 根 namespace 中 的 Action, 在 访问 时 ， 
通常 使 用 形 如 actionname 的 URI。 

如 果 一 个 Action 没有 指定 任何 命名 空间 ,如 直接 是 moo. action, 它 则 会 去 根 命名 空 
间 寻 找 。 如 果 一 个 Action 在 指定 的 命名 空间 没 被 发 现 , Struts 2 就 会 去 默认 命名 空间 
寻找 。 

代码 5-3 给 出 一 个 namespace 示例 ,假设 Web 应 用 名 为 bbs。 


代码 5-3 ”namespace 举例 


< 上 -cefault 包 在 默认 的 名 称 空间 中 --> 
< package name= "default" extends= "struts- default"> 
< action name= "login" class= "Hbs.action.LoginAction"> 
< result name= "sucoess"> /index.jsp< /result> 
< /action> 
< action name= "post" class= "Hbs.action.PostAction"> < /action> 
< /package> 


< 上 -teacher 包 在 /名 称 空间 中 --> 
< package name= "teacher" nemespace= "/" extends= "struts- default"> 
< action name= "lJogin" class= "tbs.action.LoginAction3"> 
< result name= "sucoess"> /teacher/index.jsp< /result> 
< /action> 
< action name= "post" class= "Hbs.action.PostAction2"> < /action> 
< /package> 


< !--manager 包 在 根 名 称 空间 中 --> 
< peckage namer "irenager" nameepacer "/irereger" extende= "struts— default"> 
< action name= "managerLogin" class= "kbs.action.LoginAction2"> 
< result name= "sucoess"> /manager/index.jsp< /result> 
< /action> 
< /package> 


(1) 当 请 求 http://127. 0. 0. 1:8080/bbs/login. action 时 ,Struts 2 首先 在 根 namespace 
(“*/”) 中 查找 。 如 果 找 不 到 , 则 到 上 默认 的 namespace 中 查找 。 由 于 根 namespace 中 存在 
login. action, 所 以 执行 bbs. action. LoginAction3 的 实例 。 

(2) 当 请 求 http://127. 0. 0. 1:8080/bbs/manager/login. action 时 , Struts 2 首先 
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在 /manager namespace(“/”) 中 查找 。 由 于 该 namespace 中 不 存在 login. action ,所 以 到 
默认 的 namespace 中 查找 ,也 就 是 执行 bbs. action. LoginAction 的 实例 。 

(3) 当 请 求 如 下 三 个 请 求 时 , 前 两 个 请 求 执 行 根 namespace 中 的 post. action, 后 一 
个 请 求 执行 默认 namespace 中 的 post. action 

©@ http://127. 0. 0.1:8080/bbs/post. action 

©@ http://127. 0.0.1:8080/bbs/student/post. action 

©® http://127. 0.0.1:8080/bbs/manager/post. action 

这 里 需要 注意 的 是 第 二 个 请 求 。 在 请 求 post. action 时 使 用 了 /student/post. action 
的 格式 ,而 实际 上 根本 没有 名 为 student 的 namespace 存在 , Web 应 用 程序 没有 出 错 ,也 
没有 直接 去 查找 默认 的 namespace, 而 是 首先 查找 根 namespace 中 是 否 存 在 post. action。 


526 include (包含 配置 


package 和 action 等 的 默认 配置 文件 为 struts. xml, 但 是 当 一 个 应 用 的 package、 
action \interceptors 等 配置 比较 多 时 ,如 果 都 放 到 一 个 struts. xml 文件 中 , 则 维护 起 来 比 
较 困 难 。 为 此 ,把 struts. xml 文件 分 成 多 个 配置 文件 ,然后 在 struts. xml 文件 中 使 用 
一 include> 元 素 包含 这 些 配置 文件 ,使 得 配置 文件 的 结构 更 加 清晰 ,维护 起 来 更 加 容易 。 

例如 在 一 个 电子 商务 应 用 中 ,可 以 把 用 户 配置 .商品 配置 .订单 配置 分 别 放 在 3 个 配 
置 文件 user. xml、goods. xml 和 order. xml 中 ,然后 在 struts. xml 中 将 这 3 个 配置 文件 引 
入 ,如 代码 5-4 所 示 。 


代码 5-4” 带 有 include 元 素 的 struts. xml 


< ?ml versicn= "1.0" encoding= "UIF- 8" ?> 

< IDOCTYPE, struts PUBLIC 
" /apache Software Foundation//DID Struts Configuraticn 2.3//EN" 
"http://struts.apache.org/dtds/struts- 2.3.dtd"> 

<struts> 


< include file= "user.xml"> < /include> 

< include file= "goods .xml"> < /include> 

< include file= "order.xml"> < /include> 
</struts> 


代码 5-5 给 出 了 被 包含 文件 user. xml 的 片段 。 
代码 5-5 user. xml 的 代码 片段 


< Pml versior= "1.0" encoding= "UTF- 8" ?> 

< IDOCTYEE, struts PUBLIC 
™ [apache Software Foundation//DID Struts Configuration 2.3//EN" 
"http://struts.apache.org/dtds/struts- 2.3.dtd"> 

<struts> 


< package name= "user" extends= "struts- default"> 


第 5 章 深入 Struts2 人 


<action name= "login" class= "org.shops.action.User.Iogin™> 
< result namer "sucoessn typer "redirect"> /index.jsp< /result> 
< /action> 
< action namer "register" class= "org.shops.action.User" method- "reg"> 
< result namer "sucosss" typer "redirect"> /index.jsp< /result> 
< /action> 


< /package> 


< /struts> 


被 包含 的 文件 本 身 也 是 一 个 完整 的 配置 文件 ,必须 遵守 struts-2. 3. dtd 的 定义 。 在 
利用 myEclipse 开发 Web 应 用 时 ,被 包含 的 文件 可 以 存放 在 src 目录 下 ,也 可 以 存放 在 
某 个 Java 包 下 。 例 如 , 当 上 述 user. xml 存放 在 org/shops/action/User 下 时 ,在 struts. 
xml 中 应 该 写成 如 下 形式 : 


< include file= "org/shops/action/User/user.xml"> < /include> 
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Struts 2 使 用 包 来 管理 Action 信息 ,需要 在 struts. xml 文件 中 使 用 二 package 二 元 
素 的 子 元 素 二 action 二 来 配置 Action 信息 。 

当 客 户 端 请 求 一 个 Action 时 ,Struts 框架 根据 struts. xml 中 的 配置 ,自动 将 请 求 交 
给 action 元 素 的 name 属性 所 标识 的 Action 类 的 实例 去 处 理 。 默 认 时 ,调用 该 实例 的 
execute() 方 法 。 

在 实际 的 应 用 开发 中 ,为 了 减少 Action 类 ,不 会 在 一 个 Action 类 中 只 包含 一 个 功 
能 ,而 是 把 几 个 相关 的 功能 放 在 同一 个 Action 类 中 。 例 如 在 电子 商务 应 用 中 ,围绕 订单 
可 能 包括 向 订单 中 添加 商品 ,从 订单 中 删除 某 一 个 商品 .提交 订单 .查询 订单 等 功能 。 为 
减少 Action 类 的 使 用 ,可 以 将 这 些 功 能 放 在 同一 个 Action 类 中 ,如 代码 5-6 给 出 的 
OrderAction. java 类 的 代码 片段 所 示 。 


代码 5-6 ”OrderAction. java 片段 


Eublic class OrderAction extends ActionSupport { 
Public String execute () { // 向 订单 中 添加 商品 


Teturn SUOCESS; 
} 


Public String submit (){ // 提 交 订 单 
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Teturn SUOCESS; 
} 


Public String view() { // 查 看 订单 


Teturn SUOCESS; 


当 一 个 Action 类 中 包含 多 个 功能 时 ,在 配置 Action 映射 时 ,需要 使 用 二 action 记 元 
素 的 method 属性 来 指定 action 调用 的 方法 。 

代码 5-7 中 配置 了 3 个 Action ,分 别 用 于 访问 OrderAction 类 的 execute() .submit() 和 
view() 方 法 。 


代码 5-7 在 struts. xml 中 为 同一 个 Action 类 配置 不 同 的 别名 


< package name= "orders" namespace= "/orders" extends= "struts- default"> 
< 上 -访问 aaa.action 时 ,将 调用 Orderaction 的 execute() 方 法 --> 
<action name= "add" class= "org.shops.action.OrderRcticn"> 
< result name= "sucoess" type= "redirect"> /orders.jsp< /result> 
< /action> 


< 上 -访问 simit.action 时 ,将 调用 orderaction 的 mitmit() 方 法 --> 
< action name= "submit" class= "org.shops.action.OrderAction" 
method= "submit"> 
< result name= "success" type= "redirect"> /orders.jsp< /result> 
< /action> 


< 上 -访问 view.action 时 ,将 调用 Orderaction 的 view() 方 法 --> 
< action name= "view" class= "org.shops.action.OrderAction" 
method= "view"> 
< result name= "success" type= "redirect"> /orders.jsp< /result> 


532 动态 方法 调用 


在 代码 5-7 中 ,利用 3 个 Action 分 别 访问 OrderAction 类 的 3 个 不 同方 法 。 实 际 上 ， 
在 Struts 2 中 提供 了 一 种 被 称 为 动态 方法 调用 的 方法 。 使 用 这 种 方法 ,不 需要 配置 就 可 
以 直接 调用 Action 中 的 非 execute 方法 。 

动态 方法 调用 (Dynamic Method Invocation, DMI) 是 指使 用 actionName! 
methodName. action 的 形式 来 访问 Action 类 中 的 方法 。 其 中 ,actionName 为 在 struts. 
xml 中 为 某 个 Action 类 的 execute() 方 法 配置 的 Action 名 字 ,methodName 为 该 Action 


第 5 章 深入 Struts 2 < 


类 中 的 非 execute() 方 法 。 
例如 ,对 于 代码 5-6 中 的 OrderAction 类 ,如 果 在 struts. xml 中 进行 如 代码 5-8 所 示 
的 配置 ,就 可 以 利用 order. action1del. action 调用 OrderAction 类 的 del() 方 法 。 


代码 5-8 动态 调用 类 OrderAction 中 的 方法 时 的 Action 配置 


< action name= "order" class= "org.shops.acticon.OrderAction"> 
< result name= "sucoess" type= "redirect"> /orders.jsp< /result> 
< /action> 


利用 动态 方法 调用 ,使 得 同一 个 Action 类 的 不 同方 法 共用 同一 个 配置 。 然 而 ,根据 
Struts 2 的 官方 提示 ,最 好 不 要 使 用 动态 方法 调用 ,因为 这 会 引发 安全 问题 。 程 序 员 和 网 
站 管理 者 不 会 希望 用 户 能 够 调用 没有 公开 的 方法 。 

如 果 非 要 使 用 动态 方法 调用 , 则 应 首先 确保 常量 DynamicMethodInvocation 没有 被 
设置 为 false。 


533 使 用 通配符 


在 一 个 大 型 的 Web 应 用 中 ,可 能 会 包括 几 十 个 甚至 是 上 百 个 Action 映射 。Struts 2 
提供 的 通配符 机 制 允许 把 相似 的 映射 关系 简化 成 一 个 映射 关系 。 
表 5-1 给 出 了 在 Action 配置 时 可 以 使 用 的 通配符 和 特殊 记号 。 
表 5-1 Action 配置 时 可 以 使 用 的 通配符 和 特殊 记号 


通配符 或 记号 含义 
* 可 以 匹配 0 个 或 多 个 任意 字符 ,但 是 不 包括 斜 杠 “/” 
A 可 以 匹配 0 个 或 多 个 任意 字符 ,包括 斜 杠 “/” 在 内 
\ 反 斜 杠 , 转 义 字符 
i 表示 第 n 个 通配符 所 匹配 的 值 。n 为 数字 , 取 值 范围 0~~9, 当 n 为 0 时 ,{n} 匹 配 整 
个 请 求 URI 


先 来 看 一 下 代码 5-9 给 出 的 Action 配置 。 
代码 5-9 在 Action 配置 时 使 用 通配符 


<acticn neme= "Order * " class= "crg.shops.action.OrderActicn" method= "{1}"> 
< result name= "success" type= "redirect"> /orders {1}.jsrx /result> 
< /action> 


在 代码 5-9 给 出 的 Action 配置 中 使 用 了 通配符 “* ”, 因 此 该 Action 可 以 匹配 所 有 
以 /order 为 前 组 的 URI, 例 如 /order_add、/order_submit 和 /order_remove 等 。 当 客户 
请 求 URI 为 order_add 时 ,由 于 通配符 ”x ?匹配 了 add,{1} 将 被 替换 成 add, 因 此 该 请 求 
将 调用 org. shops. action. OrderAction 的 add 方法 ; 当 Action 实例 返回 SUCCESS 时 , 结 
果 页 面 将 映射 到 /orders_add. jsp。 

接 下 来 ,看 一 下 代码 5-10 给 出 的 Action 配置 。 
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代码 5-10 在 Action 配置 时 使 用 通配符 的 另 一 个 例子 


<action name="* * " class= "org.shops.action.{1}Action" method= "{2}"> 
< result name= "success" type= "redirect"> /{1} {2}.jsp< /result> 
< /action> 


在 代码 5-9 给 出 的 Action 配置 中 使 用 了 * _* 来 为 Action 命名 ,因此 该 Action 可 以 
匹配 所 有 中 间 带 有 下 画 线 (“_”) ,但 是 不 含有 */” 的 URI 请 求 ,例如 /order_add Vuser_ 
register 和 /goods_remove 等 。 当 客户 请 求 URI 为 goods_remove 时 ,由 于 第 1 个 通配符 
匹配 了 goods, 第 2 个 通配符 匹配 了 remove, 因 此 {1} 将 被 蔡 换 成 goods,{2} 将 被 替换 成 
remove, 该 请 求 将 调用 org. shops. action. goodsAction 的 remove 方法 。 当 Action 实例 
返回 SUCCESS 时 ,结果 页 面 将 映射 到 /goods_remove. jsp。 

由 于 {0} 可 以 匹配 整个 请 求 URI, 因 此 代码 5-10 中 的 {1}_{2). jsp 也 可 以 写成 {0). jsp， 
其 效果 是 完全 一 样 的 。 

在 Action 配置 时 ,如 果 使 用 了 通配符 , 则 可 能 出 现 多 个 Action 映射 都 能 够 匹配 用 户 
请 求 的 情况 。 

来 看 一 下 代码 5-11 给 出 的 配置 文件 片段 。 

代码 5-11 多 个 Action 映射 匹配 同一 个 用 户 请 求 


< action name= "x " class= "org.shops.action.OrderAction"> 
< result name= "sucoess" type= "redirect"> /orders.jsp< /result> 
< /action> 
<acticn name= "order * " class= "org.shope.acticn.Orderpcticn'" method= "{1}"> 
< result name= "sucoess" type= "redirect"> /orders_{1}.jspx /result> 
< /action> 
<acticn neme= "order adc" class= "org.shope.acticn.Orderpcticn" method= "az> 
< result name= "success" type= "redirect"> /orders/orders.jsp< /result> 
< /action> 


当 请 求 /order_add. action 时 ,尽管 3 个 Action 映射 都 可 以 匹配 用 户 请 求 ,但 Struts 2 框 
架 会 优先 选择 第 3 个 映射 , 即 名 字 为 order_add 的 Action 映射 。 

当 请 求 /order_submit. action 时 ,Struts 2 是 不 是 优先 使 用 第 2 个 Action 映射 来 匹 
配 客户 请 求 呢 ? 经 过 验证 发 现 ,Struts 2 选择 了 第 1 个 Action 映射 ,也 就 是 名 字 为 ~*” 
的 Action 映射 来 匹配 客户 请 求 。 如 果 将 代码 5-11 中 前 两 个 Action 映射 交换 顺序 ,再 次 
请 求 /order_submit. action, 会 发 生 什 么 变化 呢 ? 验 证 表明 ,此 时 Struts 2 选择 了 名 字 为 
“order_* ”的 映射 来 匹配 客户 请 求 。 

总 结 一 下 ,Action 请 求 的 优先 级 顺序 如 下 。 

(1) 不 带 有 通配符 的 Action 映射 的 优先 级 最 高 ,会 优先 被 选择 。 

(2) 带 有 “x* ”通配符 的 Action 映射 将 按照 其 出 现在 配置 文件 中 的 顺序 进行 匹配 

534 利用 静态 参数 给 Action 传递 值 

在 前 面 的 例子 中 ,Action 类 属性 的 值 通常 利用 表单 的 输入 或 URL 请 求 参数 进行 填 
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充 。 除 了 这 两 种 方式 外 ,Struts 2 还 允许 在 struts. xml 中 配置 Action 时 利用 静态 参数 进 
行 填充 。 

struts. xml 文件 中 的 action 元 素 可 以 包含 任意 个 param 元 素 。 每 个 param 元 素 将 
映射 到 Action 类 的 一 个 属性 上 。Struts 2 框架 提供 了 一 个 Static Parameters 拦截 器 ,该 
拦截 器 能 够 把 利用 param 元 素 定义 的 静态 参数 的 值 传递 给 Action 的 属性 。 

在 代码 5-12 给 出 的 struts. xml 片段 中 ,使 用 了 一 个 利用 静态 参数 给 Action 传递 值 
的 例子 。 


代码 5-12 利用 静态 参数 给 Action 传递 值 


< action name= "addNote" class= "exanple.action.NotesAction" method= "add"> 
< param name= "uploadDir"> uploadFiles< /param> 
< /action> 


上 述 代码 为 addNote. action 设置 了 一 个 静态 参数 uploadDir, 每 当 该 Action 运行 时 ， 
它 的 uploadDir 属性 都 会 自动 被 设置 为 uploadFiles。 

535 默认 的 Acion 

通常 情况 下 , 当 请 求 的 Action 不 存在 时 , Web 服务 器 会 给 客户 端 返回 一 个 HTTP 
404 错误 。 为 了 提供 一 个 友好 的 错误 处 理 页 面 ,可 以 配置 一 个 默认 的 Action。 在 请 求 的 
Action 不 存在 的 情况 下 ,调用 默认 的 Action。 

代码 5-13 给 出 利用 default-action-ref 元 素 声 明 默 认 Action 的 方法 。 注 意 , default- 
action-ref 元 素 的 声明 必须 放 在 一 个 package 的 所 有 Action 元 素 声 明之 前 。 

代码 S-13 ”配置 默认 Action 


< package name= "default" namespace= "/" extends= "struts- default"> 
< default— action- ref name= "error"> < /default— action- ref> 
< action name= "error"> 


54 配置 result 


541 resut 映射 与 结果 类 型 


在 Action 类 的 方法 执行 完成 后 ,Struts 2 框架 需要 向 客户 端 输出 一 个 处 理 结果 ,该 
结果 可 能 是 一 个 JSP 或 HTML 页 面 , 也 可 能 是 另 一 个 Action 调用 。 在 struts. xml 中 ， 
通常 利用 result 指定 一 个 Action 实例 的 每 一 个 可 能 的 结果 码 对 应 的 输出 。 

一 个 完整 的 result 结构 如 下 : 
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< result name= "successn type— "dispatcher"™> 
< param name= "location"> /ThankYou.jsp< /param> 
</result> 
其 中 ,result 元 素 的 name 属性 表示 Action 实例 的 返回 结果 码 , 默 认 值 为 success; 
type 属性 表示 结果 类 型 ,默认 值 为 dispatcher; 子 元 素 param 表示 映射 时 所 需 参数 ,每 个 
result 元 素 可 以 有 0 到 多 个 param 子 元 素 , 参 数 location 表示 结果 视图 对 应 的 资 
源 URL。 
利用 result 属性 的 默认 值 , 可 以 将 上 述 语句 简化 成 如 下 形式 : 
<result > 
< param name= "location"> /ThankYou.jsp< /param> 
< /result> 


当 result 只 有 location 参数 时 ,可 以 将 其 缩写 成 如 下 形式 : 
< result > /ThankYou.jspx /result> 


通过 前 面 的 学 习 我 们 知道 ,Action 类 用 于 管理 应 用 程序 的 状态 (返回 结果 码 ) ,那么 
这 些 状态 对 应 的 结果 视图 就 由 结果 类 型 来 管理 。 在 struts-default. xml 中 预定 义 了 一 些 
常用 的 结果 类 型 ,如 表 5-2 所 示 。 


表 5-2 struts-default. xml 中 预定 义 的 结果 类 型 


结果 类 型 说 明 
chain 用 来 处 理 Action 链 
dispatcher 用 来 转向 页 面 ,通常 处 理 JSP 
freemarker 用 来 集成 FreeMarker 
httpheader 用 来 控制 特殊 的 HTTP 行为 
redirect 用 来 重 定向 到 一 个 URL 
redirectAction 用 来 重 定向 到 一 个 Action 
stream 用 来 向 浏览 器 返回 InputSream 对 象 ,通常 用 来 处 理 文件 下 载 
velocity 用 来 集成 Velocity 
xslt 用 来 处 理 XML/XLST 模板 
plainText 用 来 显示 原始 文件 内 容 , 例 如 文件 源 代码 


除了 struts-default. xml 中 预定 义 了 的 结果 类 型 之 外 ,Struts 2 中 的 某 些 插件 也 定义 
了 各 自 的 结果 类 型 。 例 如 ,在 struts2-json-plugin-x. x. x. jar 的 struts-plugin. xml 中 定义 
了 一 个 结果 类 型 json, 用 于 向 浏览 器 返回 JSON 数据 。 

5.4.2 一 5. 4.5 小 节 将 讲述 result 的 各 种 常见 结果 类 型 的 配置 方法 。 


542 ”dispatcher 类 型 


dispatcher 是 Struts 2 默认 的 结果 类 型 ,主要 用 于 处 理 JSP 页 面 跳 转 。 
代码 4-12 在 request 中 存放 了 一 个 字符 串 “ 您 好 ,欢迎 登录 系统 1”, 为 什么 能 够 在 代 
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码 4-13 给 出 的 welcome. jsp 页 面 中 利用 property 标签 将 其 显示 出 来 呢 ? 通过 查看 
Struts 2 源码 可 以 看 到 , dispatcher 类 型 的 实现 类 是 org. apache. struts2. dispatcher. 
ServletDispatcherResult ,该 类 在 实现 时 采用 了 Servlet 的 RequestDispatcher 来 转发 请 
求 ,这 就 意味 着 ,结果 视图 与 最 初 的 客户 请 求 将 共享 request 和 response 对 象 。 因 此 , 调 
用 Action 实例 的 页 面 中 的 表单 输入 ,以 及 Action 实例 在 request 中 存放 的 数据 ,能 够 被 
JSP 结果 视图 访问 。 

dispatcher 有 两 个 参数 ,一 个 是 location ,用 于 指定 Action 执行 完成 后 要 跳 转 到 的 目 
标 JSP; 另 一 个 是 parse, 用 于 标识 Struts 2 是 否 对 location 参数 中 的 ognl 表达 式 进行 解 
析 。parse 参数 的 默认 值 为 true。 

在 location 参数 中 ,可 以 包含 OGNL 表达 式 。 例 如 ,在 某 应 用 程序 中 允许 不 同 身份 
的 用 户 登 录 ,并 且 在 登录 成 功 后 为 不 同 身份 的 用 户 返 回 不 同 的 结果 页 面 。 假 设 用 同一 个 
Action 类 来 处 理 所 有 身份 的 用 户 请 求 ,那么 该 Action 类 应 该 具有 代码 5-14 所 示 的 形式 。 


代码 5-14 ”处 理 不 同 身份 用 户 登录 的 Action 类 


Public class LoginAction extends ActionSupport{ 
Private int userType; 
Private String folder; 
/* 省 略 了 getter 和 setter 方 法 的 代码 ,请 读者 自行 添加 * / 
Public String execute() { 
if(userType== 1) 
folder= "manager"; 
else 
folder= "user™"; 


Teturn SUOCESS; 


} 


对 于 代码 5-14 中 的 LoginAction 类 ,在 struts. xml 中 可 以 采用 代码 5-15 给 出 的 形 
式 进行 配置 。 
代码 5-15 ” 带 有 ognl 表达 式 的 result 配置 


< action name= "login" class= "org.shops.action.LoginAction"> 
< result> /$ {folder}/welome.jsp< /result> 
< /action> 


这 里 的 $ {folder) 就 是 OGNL 表达 式 , 称 其 为 动态 值 。$ {folder) 的 值 来 源 于 
Action 中 的 属性 folder, 所 以 在 Action 类 中 必须 保证 为 folder 属性 定义 了 get 方法 。 
result 的 parse 属性 就 是 用 于 控制 是 否 对 这 样 的 表达 式 进 行 解析 的 。 由 于 parse 的 默认 
值 为 true, 所 以 代码 5-15 中 对 其 进行 了 省 略 。 从 上 面 的 例子 可 以 看 到 ,当成 功 登录 的 用 
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户 为 管理 员 时 ,浏览 器 将 跳 转 到 /manager/welcome. jsp 页 面 ;否则 ,浏览 器 将 跳 转 到 / 
user/welcome. jsp 页 面 。 

另外 ,dispatcher 对 应 的 结果 视图 只 能 是 当前 应 用 程序 中 的 页 面 ,不 能 试图 利用 
dispatcher 跳 转 到 外 部 服务 器 的 某 一 个 页 面 。 结 果 页 面 在 书写 时 ,如 果 使 用 “/” 作 为 路 径 
前 级, 则 表示 该 结果 页 面 路 径 是 相对 于 当前 的 Web 应 用 程序 的 上 下 文 路 径 ;如 果 结 果 页 
面 没有 使 用 “/” 作 为 路 径 前 级 , 则 表示 该 结果 页 面 的 路 径 相对 于 当前 执行 的 Action 的 
路 径 。 

例如 ,对 于 代码 5-16 给 出 的 配置 , 当 请 求 http://127. 0. 0. 1: 8080/notes/login. 
action 时 ,如 果 Action 返回 结果 代码 为 success, 将 跳 转 到 /notes/manager/welcome. jsp 
页 面 ;如 果 Action 返回 结果 代码 为 error, 将 跳 转 到 /notes/error. jsp。 


代码 5-16 ”结果 页 面 的 配置 路 径 


< package name= "aaa" nemespace= "/menager" extends= "struts- default"> 
< action name= "Jogin" class- "exanple.action.ILoginAction"> 
< result> weloome.jsp< /result> 
< result name= "error"> /error.jsp< /result> 
< /action> 
< /package> 
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与 dispatcher 类 型 不 同 ,利用 redirect 结果 类 型 ,可 以 将 JSP 页 面 \.Action 以 及 外 部 
网 址 作为 结果 视图 。 
我 们 先 做 一 个 测试 ,修改 4. 2 节 中 给 出 的 Struts 2 例子 。 对 strus. xml 中 名 为 login 
的 Action 的 result 结果 进行 修改 ,将 结果 码 为 success 的 结果 类 型 由 默认 的 dispatcher 
修改 为 redirect, 即 
< action name= "login" class= "exanple.action.LoginAction"> 
< result typenm "redirect"> /welome.jsp< /result> 
< result name= "login"> /login.jsp< /result> 
< /action> 
利用 浏览 器 访问 http://localhost:8080/notes/ ,在 输入 完 和 4. 2 节 相 同 的 用 户 名 和 
密码 后 ,浏览 器 将 显示 如 图 5-2 所 示 的 画面 。 


€ 全 © {O127.0.0.1:8080/notes/velcone. jsp 


您 好 ， 欢 迎 登 录 系 统 ! 


图 5-2 利用 redirect 重 定向 后 的 成 功 页 面 


仔细 比较 图 5-2 和 图 4-1 ,会 发 现 两 点 不 同 。 
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(1) 图 4-1 中 显示 出 了 登录 账号 zhangsan; 图 5-2 中 却 没 有 显示 出 登录 账号 。 

(2) 图 4-1 中 显示 的 URL 为 http://localhost:8080/notes/login. action ,这 个 URL 
和 登录 页 面 (代码 4-3 中 给 出 的 login. jsp) 的 表单 的 Action 的 属性 值 刚好 相同 ;而 图 5-2 
中 显示 的 URL 为 http://localhost:8080/notes/welcome. jsp, 这 个 URL 和 redirect 结果 
视图 是 一 致 的 。 

之 所 以 会 产生 这 样 的 不 同 ,原因 在 于 redirect 结果 类 型 的 实现 类 为 org. apache. struts2. 
dispatcher. ServletRedirectResult, 该 类 采用 HttpServletResponse 的 sendRedirect 方法 将 请 求 
重 定向 到 目标 资源 。 也 就 是 说 ， 当 采用 redirect 作为 结果 类 型 时 ,Web 服务 器 向 浏览 器 
发 送 一 个 重 定向 操作 ,该 操作 将 在 HTTP 响应 头 部 封装 一 个 重 定向 页 面 ,如 图 5-3 所 示 。 
然后 ,浏览 器 向 服务 器 产生 一 个 新 的 HTTP 请 求 , Web 服务 器 把 目标 资源 返回 给 浏 
览 器 。 


302Meved Tenporaiy 1270,0.1:8080 0 1270.0.1:8080 


Request Headers From Upload stream 


Content-Length 30 
Content- Type colication/s-mer fors-uriencoded 


GET welcomejsp 200 0 1270,0.1:8080 1478 1270,0,1:8080 


图 5-3 firebug 捕捉 的 redirect 结果 类 型 的 HTTP 交互 


由 于 在 采用 redirect 作为 结果 类 型 时 ,一 次 用 户 交互 过 程 中 存在 两 次 HTTP 请 求 ， 
Web 服务 器 对 于 每 一 个 HTTP 请 求 都 会 创建 一 个 线程 进行 管理 ,每 一 个 线程 都 具有 自 
已 的 ActionContext。 而 ActionContext 是 线程 安全 的 ,因此 用 于 处 理 上 一 个 HTTP 请 
求 的 线程 保存 的 数据 无 法 在 新 的 线程 中 访问 。 如 果 某 些 数据 在 目标 资源 中 必须 访问 , 则 
可 以 采用 两 种 方式 来 处 理 ,一 种 方式 是 利用 session 传递 数据 ; 另 一 种 方式 是 利用 请 求 参 
数 传递 数据 。 由 于 session 中 能 够 保存 的 数据 有 限 ,一般 采用 第 二 种 方式 。 对 于 上 述 例 
子 , 可 以 按照 代码 5-17 配置 Action 的 结果 映射 。 


代码 5-17 为 结果 视图 配置 请 求 参数 


< package name= "default" namespace= "/" extends= "struts- default"> 
< 上 -第 一 种 配置 请 求 参 数 的 方法 --> 
<acticn name= "login" class= "exanple.action.LoginAction"> 
< result typer "redirect"> /welcome.jsp?userNemer $ {userNeme} 
< /result> 
< /action> 
< 上 -第 二 种 配置 请 求 参数 的 方法 一 > 


< 上 = 


us Web 应 用 程序 开发 技术 一 JSP 十 Struts 2 


< action name= "login" class= "exanple.action.IoginAction"> 
< result typer "redirect"> 
< param name= "location"> /welcome.]jsp< /param> 
< perem neme= "userNemen> $ {userNeme}< /paren> 
< /result> 
< /action> 
—> 


< /package> 


在 重 定向 后 ,浏览 器 显示 的 URL 地 址 为 http://127. 0. 0. 1:8080/notes/welcome. 
jsp?userName 王 zhangsan。 此 时 ,可 以 在 welcome. jsp 中 利用 下 述 语句 获取 userName 
参数 的 值 。 

< 3:property value= 啡 Parameters.userName[0]"/> 

在 采用 第 一 种 方式 向 目标 资源 传递 结果 时 ,如 果 重 定向 后 的 URL 中 具有 两 个 以 上 的 
请 求 参 数 , 例 如 http://127. 0. 0. 1:8080/notes/welcome. jsp?userName 一 zhangsan&.id 一 1 , 必 
须 将 其 中 的 “&.” 修 改 为 转 义 字符 “&amp;”, 即 

< result type= "redirect"> /welcome.jsp?userName= $ {userName} &anp; id $ {id} 

< /result> 

redirect 结果 类 型 具有 三 个 参数 : location ,parse 和 anchor。 前 两 个 和 dispatcher 结 
果 类 型 中 的 含义 一 样 。 参 数 anchor 用 于 指定 重 定向 到 目标 资源 中 的 锚 。 

下 面 对 结 果 类 型 redirect 和 dispatcher 进行 简单 的 比较 。 

(1) URL 不 同 , 采 用 dispatcher 作为 结果 类 型 ,刷新 浏览 器 时 ,会 重新 发 送 Action 执 
行 请 求 , 会 导致 Action 重新 执行 ,Struts 2 框架 会 重新 映射 结果 视图 ;采用 redirect 作为 
结果 类 型 ,刷新 浏览 器 时 ,不 会 重新 发 送 Action 执行 请 求 ,Action 不 会 再 次 执行 ,浏览 器 
只 是 把 redirect 的 结果 视图 重新 发 送 给 客户 端 而 已 。 因 此 ,redirect 结果 类 型 将 会 把 用 户 
请 求 重新 定向 到 另 一 个 资源 ,而 不 是 把 控制 权 交 给 该 资源 ;而 dispatcher 结果 类 型 会 将 整 
个 控制 器 交 给 目标 资源 。 

这 一 点 在 某 些 场合 很 有 用 ,例如 在 用 户 注册 时 ,为 防止 用 户 单 击 浏览 器 的 “刷新 " 按 
钮 ,造成 两 次 提交 ,可 以 采用 redirect 方式 来 解决 。 

(2) 采用 redirect 方式 ,目标 资源 不 能 访问 Action 实例 、Action 错误 及 字段 错误 ;而 
dispatcher 能 够 轻松 访问 这 些 数据 。 

(3) redirect 方式 可 以 将 用 户 重 定向 到 一 个 外 部 的 资源 。 在 Action 实例 返回 状态 
后 ,如 果 只 是 需要 将 用 户 定 向 到 一 个 内 部 的 资源 ,并 且 无 须 担心 用 户 执行 刷新 操作 时 , 则 
采用 dispatcher 方式 要 更 好 一 些 , 因 为 这 么 做 响应 速度 更 快 。 重 定向 操作 使 得 浏览 器 不 
得 不 发 送 一 个 新 的 HTTP 请 求 。 
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redirectAction 结果 类 型 与 redirect 结果 类 型 的 行为 很 相似 ,但 redirectAction 类 型 
不 能 将 目标 结果 定向 到 一 个 网 页 ,只 能 重 定向 到 另 一 个 Action 实例 。 
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因为 redirectAction 结果 类 型 的 重 定向 操作 也 会 引发 浏览 器 发 送 第 二 个 HTTP 请 
求 , 因 此 第 二 个 Action 实例 无 法 共享 第 一 个 Action 实例 的 ActionContext。 如 果 需 要 共 
享 数 据 , 则 可 以 采用 与 redirect 结果 类 型 相同 的 方法 处 理 。 

redirectAction 结果 类 型 的 两 个 主要 参数 是 actionName 和 namespace。 默 认 参 数 
actionName 用 于 指示 需要 重 定向 的 目标 Action, namespace 用 于 指示 目标 Action 的 命 
名 空间 , 缺 省 时 表示 目标 Action 和 当前 Action 位 于 同一 命名 中 。 

代码 5-18 给 出 了 利用 redirectAction 结果 类 型 进行 重 定位 的 几 种 情况 。 


代码 5-18 ”利用 redirectAction 配置 result 映射 


<struts> 
< package name= "default" namespace= "/user" extends= "struts- default"> 
< !-- 重 定向 到 统一 命名 空间 的 list.action 一 > 
< action name= "login" class= "Hbs.action.LoginAction"> 
< result type= "redirectAction"> list< /result> 
< /action> 


< action name= "list" class= "Hbs.action.PostAction" > 
< result> /postList.jsp< /result> 
< /action> 
< /package> 


< Fackage name= "default" namespace= "/rmenager" extends= "struts- default"> 
< !-- 重 定向 到 另 一 命名 空间 的 第 一 种 方法 --> 
< action name= "bulletin" class= "bbs.action.BulletinAction" > 
< result > /user/list< /result> 
< /action> 


< !-- 重 定向 到 另 一 命名 空间 的 第 二 种 方法 --> 
<action name= "bulletin2" class= "Hbs.action.BulletinAction"> 
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chain 结果 类 型 的 用 途 是 构成 一 个 Action 链 , 前 一 个 Action 将 控制 权 转 交 给 下 一 个 
Action, 后 一 个 Action 可 以 共享 前 一 个 Action 的 状态 。 

chain 结果 类 型 的 实现 类 是 com. opensymphony. xwork2. ActionChainResult, 它 有 
三 个 主要 参数 : actionName、namespace 和 method。 前 两 个 参数 的 用 法 与 redirectAction 
结果 类 型 中 的 参数 一 样 ,参数 method 用 于 指示 执行 目标 Action 中 的 哪个 方法 。 
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代码 5-19 是 在 Struts 2 官方 文档 的 基础 上 稍 加 修改 得 到 的 ,演示 了 chain 结果 类 型 
的 用 法 。 


代码 5-19 ”用 chain 结果 类 型 配置 result 映射 


< package name= "public" extends= "struts- default"> 
< !-- 利 用 默认 参数 将 creataccount 链 向 login --> 
< action name= "createAcoount" class= ".."> 
< result type= "chain"> loginc /result> 
< /action> 


< action name= "login" class=".."> 
< !-- 链 向 另 一 个 命名 空间 的 dashboard.acticn 的 revise() 方 法 --> 
< result type= "chain"> 
< param name= "actionName"> dashboarde /param> 
< param name= "namespaoe"> /secure< /param> 
< param name= "method"> revise< /param> 


< package name= "secure" extends= "struts- default" namespace= "/secure"> 
< action name= "dashboard" class=".."> 
< result> dashboard.jsp< /result> 
< /action> 
< /package> 


注意 : 

(1) 使 用 chain 结果 类 型 配置 result 时 ,目标 Action 不 能 有 扩展 名 (. action); 

(2) 使 用 chain 结果 类 型 配置 result 时 ,不 能 试图 利用 请 求 参 数 在 Action 间 传 递 数 
据 , 也 就 是 不 能 出 现 类 似 于 如 下 的 配置 : 


< result type= "chain"> login.action?userName= "zhangsan"< /result> 
这 种 配置 方式 是 不 行 的 ,因为 这 里 要 求 配置 的 是 要 链接 的 Action 的 name, 不 能 传递 参 


数 。 那 么 ,要 传递 参数 怎么 办 呢 ? 可 以 利用 ActionContext 或 是 ServletActionContext ,将 需 
要 传递 的 数据 保 存在 request 中 站 
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plaintext 结果 类 型 用 于 显示 文件 的 源码 。HTTP 默认 的 服务 器 响应 类 型 ContentType 
为 text/html。 因 此 当 发 出 如 下 请 求 时 .浏览 器 将 按照 HTML 语法 规则 对 welcome. jsp 
进行 解析 ,显示 出 来 的 是 welcome. jsp 的 制作 效果 ,而 不 是 源 文件 。 
http://127.0.0.1:8080/welocme.jsp 


但 是 某 些 时 候 ,可 能 需要 在 浏览 器 中 向 用 户 显示 某 个 页 面 的 源 代码 是 什么 样 的。 为 了 显 
示 源 码 , 可 以 利用 Struts 2 框架 提供 的 plainText 结果 类 型 来 配置 result 结果 映射 。 
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plainText 结果 类 型 的 实现 类 是 org. apache. struts2. dispatcher. PlainTextResult, 它 
有 两 个 参数 location 和 charSet。 默 认 参 数 location 给 出 需要 显示 源 代码 的 页 面 的 路 径 ， 
可 选 参数 charSet 用 于 设置 服务 器 响应 的 字符 编码 。 

代码 5-20 演示 了 plainText 结果 类 型 的 用 法 。 


代码 5-20 ”用 plainText 结果 类 型 配置 result 映射 


< action name= "sourceCode"> 
< result type= "plainText"> 
< param name= "location"> /welcome.jsp< /param> 
< param name= "charSet"> utf- 8< /paran> 
< /result> 
< /action> 


在 这 个 例子 中 ,通过 访问 sourceCode. action 可 以 获得 welcome. jsp 的 源码 。 参 数 
charSet 的 值 为 utf-8, 因 此 服务 器 在 响应 sourceCode. action 时 ,服务 器 响应 类 型 将 被 设 
置 为 text/plain; charset 二 gbk。 注 意 , 这 里 的 charSet 一 定 要 和 welcome. jsp 页 面 的 
charSet 保持 一 致 ,否则 可 能 引发 中 文 乱码 问题 。 
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前 面 讲 到 的 result 元 素 都 是 作为 Action 的 子 元 素 出 现 的 ,这 被 称 为 局 部 result, 只 
能 作为 本 Action 元 素 的 结果 视图 。 当 多 个 Action 使 用 同一 个 result 时 ,可 以 配置 全 局 
result。 全 局 result 在 某 些 场合 比较 有 用 ,例如 应 用 程序 的 每 个 页 面 都 会 判断 用 户 是 否 
登录 。 如 果 没 有 登录 , 则 都 要 跳 转 到 登录 页 面 。 此 时 ,就 可 以 配置 全 局 result, 让 所 有 
Action 共享 这 个 全 局 的 result, 而 不 用 为 每 个 Action 都 配置 一 个 跳 转 到 登录 页 面 的 
result 。 

全 局 result 使 用 global-results 标签 进行 配置 。 全 局 result 除了 配置 的 位 置 不 同 外 ， 
其 他 格式 与 局 部 result 是 完全 一 样 的 。 

代码 5-21 演示 了 全 局 result 的 配置 方法 。 

代码 5-21 配置 全 局 result 


< package name= "default" extends= "struts- default"> 
< 上-- 全 局 result: login 和 error --> 
<global- results> 
< result neme= "login"> /login.jsp< /result> 
< result nemer "error"> /error.jsp< /result> 
< /glcbal- results> 


< action name= "login" class= "Hbs.action.LoginAction"> 
< result> /index.jsp< /result> 
< /action> 
< action name= "post" class= "Hbs.action.PostAction"> 
< result> /post.jsp< /result> 
< 上 -名 为 error 的 局 部 result 一 > 
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< result name= "error"> /error/error.]jspx /result> 
< /action> 
< /package> 


在 这 个 例子 中 配置 了 两 个 全 局 result: login 和 error。 当 login. action 或 post. action 
返回 login 结果 码 时 ,Struts 2 将 把 /login. jsp 响应 给 浏览 器 。 但 是 ,如 果 Action 返回 的 
结果 码 为 error, Struts 2 框架 会 如 何 处 理 呢 ? 

在 回答 上 述 问 题 之 前 ,有 必要 研究 在 配置 了 全 局 result 之 后 , Struts 2 框架 寻找 
result 的 顺序 。 假 设 现在 Action 类 返回 一 个 名 为 error 的 结果 码 ,Struts 2 将 按照 下 面 的 
顺序 查找 名 为 error 的 result 映射 。 

(1) 查找 当前 Action 是 否 配置 了 一 个 名 为 error 的 局 部 result。 如 果 有 ,就 执行 这 个 
result; 如 果 没 找到 , 则 执行 下 一 步 。 

(2) 查找 当前 package 中 是 否 配置 了 一 个 名 为 error 的 全 局 result。 如 果 有 ,就 执行 
这 个 result; 如 果 没 找到 , 则 执行 下 一 步 。 

(3) 递归 查找 当前 包 的 父 包 中 是 否 配置 了 一 个 名 为 error 的 全 局 result。 如 果 有 ,就 
执行 这 个 result; 如 果 没 找到 , 则 执行 下 一 步 。 

(4) 抛 出 Exception 。 

由 此 可 见 , 在 局 部 result 和 全 局 result 都 有 能 匹配 的 result 映射 时 ,起 作用 的 是 局 部 
result。 至 此 ,不 难看 出 上 例 中 , 当 Action 返回 的 结果 码 为 error 时 ,Struts 2 框架 的 处 理 
方式 。 
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不 管 如 何 精细 编写 应 用 程序 和 检查 代码 ,总 是 会 有 bug 出 现 。 在 Java 中 ,通常 利用 
try/catch 语句 块 来 捕捉 异常 。 异 常 映射 是 Struts 2 框架 提供 的 一 个 处 理 Action 类 异常 
的 有 力 工具 。 利 用 异常 映射 ,可 以 为 用 户 提供 一 个 更 加 友好 的 界面 ,而 不 是 一 堆 错 误 代 
码 信 息 。 蜡 常 映射 允许 采取 声明 式 异常 处 理 ,或 是 采用 手工 编写 try/catch 的 方式 抛 出 
异常 。Action 方法 抛 出 的 异常 能 够 被 自动 捕捉 ,然后 经 过 映射 ,指向 一 个 预定 义 好 的 
result。 

在 struts 配置 文件 中 ,异常 映射 可 以 通过 exception-mapping 元 素 完 成 。 该 元 素 具 
有 两 个 属性 : exception 和 result。exception 属性 用 于 指定 需要 捕捉 的 异常 类 型 ,例如 
java. lang. Exception 等 result 属性 用 于 指定 一 个 result 结果 映射 的 名 字 ,该 结果 映射 可 
以 来 自 于 当前 的 Action ,也 可 以 来 自 于 global-results 声明 。 

在 Action 元 素 中 声明 的 异常 映射 称 为 局 部 异常 映射 ,在 global-exception-mappings 
中 声明 的 异常 映射 称 为 全 局 异常 映射 。 当 异常 发 生 时 ,Struts 2 框架 的 exception 拦截 器 
会 按照 如 下 顺序 去 匹配 异常 映射 (对 比 局 部 结果 和 全 局 结果 的 查找 顺序 ,可 以 很 容易 地 
理解 局 部 异常 映射 和 全 局 异常 映射 的 查找 顺序 ) 。 

(1) 查找 抛 出 异常 的 Action 中 是 否 声明 了 针对 该 异常 的 映射 。 如 果 找 到 ,就 执行 这 
个 exception 的 映射 配置 ;如 果 没 有 ,就 执行 下 一 步 。 
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(2) 查找 当前 package 里 面 的 全 局 异常 映射 是 否 声明 了 针对 该 异常 的 映射 。 如 果 找 
到 ,就 执行 这 个 exception 的 映射 配置 ;如 果 没有 ,就 执行 下 一 步 。 

(3) 递归 地 查找 父 包 的 全 局 异常 映射 是 否 声明 了 针对 该 异常 的 映射 。 如 果 找 到 ,就 
执行 这 个 exception 的 映射 配置 ;如 果 没 有 ,就 执行 下 一 步 。 

(4) 将 exception 抛 出 给 Struts 2 去 处 理 。 

换 句 话说 ,在 异常 映射 匹配 时 ,局 部 异常 映射 优先 于 全 局 异常 映射 。 

代码 5-22 给 出 了 Struts 2 官方 文档 中 配置 异常 映射 的 例子 。 


代码 5-22 ”Java 的 异常 捕捉 方式 


<struts> 
< package name= "default"> 


<glcbal- results> 
< result neme= "login" type= "redirect"> /Login.acticnc /result> 
< result neme= "Exoepticon"> /Excepticn.jspxc /result> 

< /glcbal- results> 

< 上 -全 局 异常 映射 --> 


< action name= "DataAcoess" class= "ccm.company.Datanccess"> 
< 上 -局 部 异常 映射 -一 > 
<excepticnr- mapping excepticnm "ccm.ccnpany.SecurityExcepticnn 
result= "login"/> 
< result name= "SQLException" 
type= "chain"> SQLExosptionAction< /result> 


在 这 个 例子 中 , 当 发 生 java. sql. SQLException 异常 时 ,Struts 2 框架 将 异常 交 给 / 
SQLExceptionAction. action 处 理 ; 当 发 生 java. lang. Exception 异常 时 , 跳 转 到 / 
Exception. jsp 页 面 ; 当 发 生 com. company. SecurityException 异常 时 , 跳 到 /DataAccess. 
jsp 页 面 。 

每 当 一 个 exception-mapping 元 素 捕捉 到 一 个 异常 ,Struts 2 的 exception 拦截 器 自 
动向 值 栈 添加 以 下 两 个 对 象 。 

(1) exception: 表示 被 捕获 异常 的 exception 对 象 。 

(2) exceptionStack: 存储 异常 信息 的 堆栈 。 

可 以 在 错误 处 理 页 面 使 用 Struts 2 的 标签 来 输出 异常 信息 。 
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< s:property value= "exosption.message"/> 
< s:property value= "exosptionStack"/> 


56 案例 2: 用 Struts 2 改写 留言 板 的 数据 模型 


本 节 研 究 利 用 Action 类 来 封装 第 3 章 中 留言 板 程序 JSP 页 面 中 用 到 的 业务 逻辑 。 

1 编写 Logntcdion 类 

LoginAction 类 封装 了 与 用 户 登 录 有 关 的 业务 逻辑 , 它 取 代 了 第 3 章 案例 1 中 的 
doLogin.jsp 和 logout. jsp 文件 ,内 容 如 代码 5-23 所 示 。 由 于 第 3 章 给 出 的 留言 板 的 
DAO 层 已 经 封装 了 与 数据 库 有 关 的 操作 ,因此 LoginAction 类 在 对 登录 用 户 进行 身份 验 
证 时 ,可 以 直接 调用 相应 的 DAO 接口 的 方法 。 


代码 5-23 LoginAction 类 


Package notes.action; 

import java.util .Map; 

import notes.dao.UserDao; 

jimport notes .model .User; 

jimport om.opensyrphony .xwork2. * 7 


Public class LoginAction extends Actionsupport { 
Private String userName; 
Private String password; 
/* 省略 了 get 和 set 方 法 * / 


Public String execute () throws Exosption { 
UserDao userDao= new UserDaoImpl (); 
User user= userDao.findUeer (userNemre, password); ”/* 调用 DD 接 口 的 方法 * / 


if(null==user) { /* 未 通过 用 户 验证 ,重新 定向 到 登录 页 面 * / 
this.addactionError ("用 户 名 或 密码 错误 !"); 
retum LOGIN; 

§ 

else{ /* 将 登录 用 户 信 息 保存 到 session 中 ,返回 sucosss 结果 码 * / 


ReticnContext oontiext= ActionContext .getContext (); 
Map sessicnr ontext .getSession(); 

session.put ("user", user); 

retum SUOCESS; 


3 


/* 注销 用 户 登录 * / 
Public String logout (){ 
RcticncContext context= RctionContext.getContext () 
Map sessicn= context.getSession(); 
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3e3sion.clear (); /* 清除 session 中 的 信息 * / 
return IOGIN; /< 返回 login 结 果 码 ,重新 定向 到 登录 页 面 * / 


代码 5-24 所 示 的 NotesAction 类 封装 了 与 留言 有 关 的 业务 逻辑 ,包括 获取 留言 列 
表 , 添 加 留言 和 获取 留言 的 详细 内 容 等 , 它 取 代 了 第 3 章 案例 1 中 的 doLogin. jsp 和 
index. jsp 中 的 Java 脚本 。 


代码 5-24 ”NotesAction 类 


Package notes.action; 

import java.util.* ; 

import notes.dao.NotesDao; 

import notes.model.* ; 

inport om.cpensyrphony.xwork2. * ; 


piblic class NotesAction extends ActionSupport { 
private Notes note; 
private List< Notes> notes= new ArrayList< Notes> (); 
private int noteId; 
/* 省 略 了 gat 和 set 方 法 * / 


Public String list() { /# 列 出 所 有 留言 的 信息 * / 
NotesDao notesDacr new NotesDacImpl () 
notes= notesDao.getAllNotes ()7 /* 调用 pO 接口 的 方法 * / 
retum SUOCESS; 
} 
Public String ada() { /* 添加 一 条 新 的 留言 * / 
if ull==note) retum INEUT; /* 留言 为 空 , 返 回 input 结果 码 * / 


ActionContext. omtext= ActiconContext .gatContext (); 

Map sessiconr oontext .getSession(); 

User user= (User) session.get ("user"); 

证 (null==user)retum IOGIN; /* 用 户 未 登录 ,返回 login 结 果 码 * / 


note.setUser (user); 
NbtesDao nptesDacr new NotesDaoTpl (); /* 调用 Po 接口 的 方法 * / 
notesDao.adcNote (note) ; 
retum SUOCESS; 
} 


Public String detail() { /* 获取 某 条 留言 的 详情 * / 
NotesDao notesDao= new NotesDaoInp] (); 
note= notesDao.getNoteById (noteId) ; /* 调用 pao 接口 的 方法 */ 


Teturn SUOCESS; 
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2 配置 Acio 类 

代码 5-25 给 出 了 留言 板 程 序 中 用 到 的 Action 和 result 配置 。 由 于 多 个 Action 都 会 
返回 LOGIN 结果 码 , 故 将 其 定义 为 全 局 result。 由 于 代码 中 已 经 给 出 了 详细 的 注释 ,这 
里 不 再 袭 述 ,请 读者 自行 研究 每 个 Action 和 result 映射 。 


代码 5-25 留言 板 的 struts. xml 文件 


< ?ml version= "1.0" encoding= "UIF- 8" ?> 
< IDOCTYFE struts PUBLIC 
™— /apache Software Foundation//DID Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts- 2.0.dtd"> 


< struts> 
< package name= "default" namespace= "/" extends= "struts- default"> 
< 上 -配置 全 局 result --> 
<glcbal- results> 
< result name= "login"> WEB- INFV/jsp/login.jspc /result> 
< /gldbal- results> 


< 上 -配置 login.action, 对 应 Ioginaction 的 execute 方 法 ,成 功 后 重 定向 到 
listNotes.action ——> 

< action name= "Jogin" class= "notes.action.LoginAction"> 
< result type= "redirectAction"> listNotes.actionc /result> 

< /action> 


< 上 -配置 logout.action, 对 应 Ioginaction 的 logput 方 法 --> 
< action name= "logout" class= "notes.action.LoginAction" 
method= "logout" /> 


< 上 -配置 listNotes.action, 对 应 NotesAction 的 list 方 法 一 > 
< action name= "listNotes" class= "notes.action.NotesAction" 
method= "list"> 
< result name= "success"> WEB- INF/jsp/index.jspx< /result> 
< /action> 


< 上 -配置 addNpte.acticn, 对 应 NotesAction 的 add 方 法 --> 
< action name= "addNote" class= "notes.action.NotesAction" 

method- "add"> 

< result name= "success" type= "redirectAction"> 

listNotes 

< /result> 

< result name= "input"> WEB- INF/jsp/post.jsp< /result> 
< /action> 


< 上 -配置 dstail.action, 对 应 NotesAction 的 detail 方 法 --> 
< action name= "detail" class= "notes.action.NotesAction" 
method- "detail"> 
< result name= "sucoess"> WEB- INF/jsp/detail.jsp< /result> 
< /action> 
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</struts> 


同步 训练 


1. 为 留言 板 程序 添加 实现 注册 功能 的 Action 类 ,并 在 struts. xml 对 其 进行 配置 。 
2. 编写 站 内 短信 系统 的 Action 类 ,要 求 相 近 的 功能 放 到 同一 个 Action 中 实现 ,并 
在 struts. xml 对 其 进行 配置 。 


hapter 0 
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61 OGN 表达 式 


OGNL(Object Graph Navigation Language, 对 象 图 导航 语言 ) 是 一 种 强大 的 表达 式 
语言 , 它 通过 简单 一 致 的 语法 ,可 以 任意 存 取 对 象 的 属性 或 者 调用 对 象 的 方法 ,能 够 遍历 
整个 对 象 的 结构 图 ,实现 对 象 属性 类 型 的 转换 等 功能 。Struts 2 采用 OGNL 作为 表达 式 
语言 ,允许 程序 员 利 用 OGNL 访问 ActionContext 中 的 数据 。OGNL 的 功能 比较 多 ,本 
书 只 介绍 Struts 2 程序 员 在 开发 Web 应 用 程序 中 能 够 用 到 的 部 分 。 对 OGNL 表达 式 感 
兴趣 的 读者 可 以 访问 http://commons. apache. org/ognl/。 


611 AcionConted 和 Value Stack 


每 当 一 个 Action 被 调用 ,Struts 2 就 会 创建 一 个 ActionContext。ActionContext 中 
保存 着 该 Action 对 象 和 其 他 运行 时 的 一 些 数据 ,例如 请 求 参数 和 会 话 等 。Value Stack 
指 的 是 位 于 ActionContext 中 ,用 于 保存 对 象 的 一 个 栈 , 如 图 6-1 所 示 。 该 栈 保存 着 一 些 
OGNL 可 以 存 取 访问 的 数据 ,例如 OGNL 表达 式 可 以 访问 的 数据 ,Struts 2 标签 产生 的 
一 些 中 间 数 据 等 。 


Stack Context 


Object 0 -一 parameters 
application 


request 


Object nl Session 


Objectn attr 


Value Stack 


图 6-1 Value Stack 


Value Stack 在 Struts 2 中 扮演 着 极其 重要 的 角色 。 在 Action 处 理 过 程 中 ,拦截 器 
需要 访问 Value Stack,JSP 结果 页 面 也 需要 访问 Value Stack ,才能 获得 Action 的 属性 和 
其 他 信息 。 

从 图 6-1 可 以 看 出 ,ActionContext 除了 包括 Value Stack 之 外 ,还 包含 了 与 application、 
session、request、parameters 和 attr 等 有 关 的 上 下 文 对 象 。 每 一 个 上 下 文 对 象 都 是 一 个 
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Map 对 象 ,使 得 程序 员 能 够 很 方便 地 访问 当前 应 用 程序 的 ServletContext、 当 前 请 求 的 会 
话 级 和 请 求 级 参数 等 。attr 能 够 依次 搜索 保存 在 request、session 和 application 对 象 中 
的 数据 。 


612 访问 Value Stack 中 的 元 素 

可 以 使 用 以 下 几 种 形式 中 的 某 一 个 访问 Object Stack 里 某 个 对 象 的 属性 。 
对 象 名 .属性 名 

对 象 名 [' 属 性 名 "] 

对 象 名 [" 属 性 名 站 


其 中 ,object 为 对 象 名 ;property 为 对 象 的 属性 。 
除了 直接 利用 上 述 形式 访问 对 象 的 属性 外 ,Struts 2 还 允许 使 用 下 标的 形式 访问 对 
象 的 属性 ,例如 : 


[0] .userName 


访问 的 是 栈 中 第 一 个 对 象 的 userName 属性 ,也 可 以 写成 [0]['userName] 或 [0] 
["username" ]。 

相应 地 ,可 以 利用 [1j. useName 访问 栈 中 的 第 二 个 对 象 的 userName。 

在 使 用 LN]. xxx 语法 时 ,要 注意 位 置 序号 的 含义 , 它 并 不 是 表示 获取 Value Stack 中 
索引 为 N 的 对 象 ,而 是 从 Value Stack 中 的 第 N 个 位 置 查找 对 象 xxx。 

如 果 所 要 访问 的 Value Stack 中 的 对 象 本 身 含 有 属性 ,可 以 使 用 相同 的 请 法 访问 这 
些 属性 。 例 如 , 某 个 Action 中 有 一 个 note 对 象 ,note 对 象 本 身 又 具有 一 个 title 属性 ,这 
时 可 以 用 下 面 的 语句 访问 title: 


[0] .note.title 


613 访问 Stack Contex 中 的 对 象 

可 以 通过 如 下 形式 访问 ActionContext 中 的 对 象 。 

# 对 象 名 .属性 名 

# 对象 名 [" 属 性 名 中 

# 对 象 名 [" 属 性 名 站 

例如 ,访问 请 求 属性 userName 时 ,可 以 使 用 以 下 表达 式 。 

# request .userName 

访问 会 话 属性 User 的 userName 属性 ,可 以 使 用 以 下 表达 式 。 
# session.user.userName 

而 表达 式 


#attr.welome 
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将 依次 从 request\session 和 application 中 搜索 属性 welcome。 
614 访问 静态 属性 和 静态 方法 


Struts 2 允许 访问 保存 在 Value Stack 中 的 对 象 的 静态 属性 和 静态 方法 ,也 允许 访问 
这 些 对 象 的 public 类 型 的 属性 和 方法 。 
访问 静态 属性 和 静态 方法 的 格式 如 下 : 


8 类 名 8 属性 名 
8 类 名 8 方法 名 其 数列 表 ) 


其 中 ,类 名 为 类 的 全 称 ( 含 包 名 )。 当 省 略 类 名 时 ,默认 使 用 的 类 是 java. lang. Math， 
例如 : 


@e@E // 访 问 java.lang.Math 的 静态 属性 EE 
eefloor (32.56) // 调 用 java.lang.Math 的 静态 方法 floor 


如 果 和 希望 访问 压 人 Value Stack 中 的 某 个 对 象 的 public 方法 ,可 以 使 用 如 下 格式 。 
对 象 名 方法 名 懈 数 列表 ) 


615 访问 集合 元 素 

很 多 情况 下 ,要 利用 OGNL 对 一 些 集合 数据 进行 操作 。 

1 数组 

可 以 像 访问 普通 属性 那样 访问 数组 元 素 的 属性 。 例 如 ,Action 类 中 有 一 个 数组 属性 
numbers ,并 且 编 写 了 getNumbers() 。 

String[] nmibers= {"one", "two", "three", "four"} 


可 以 像 使 用 Java 中 的 数组 那样 去 访问 numbers, 例 如 : 


mumbers[2] // 返 回 数组 元 素 中 的 第 3 个 元 素 ,此 处 为 字符 串 "three" 
nunbers.length // 返 回 数组 元 素 的 长 度 , 此 处 为 4 
2 Lst 


在 利用 Struts 2 的 标签 进行 视图 设计 时 ,经 常 需要 创建 列表 。 利 用 OGNL 表达 式 创 
建 列表 的 方法 为 : 使 用 花 括 号 将 元 素 括 起 来 ,元 素 之 间 使 用 逗号 分 隔 。 例 如 ,表达 式 

{"one", "two", "three", "four"} 
创建 了 一 个 长 度 为 4 个 元 素 的 List 对 象 ,元 素 类 型 为 String。 

对 于 List 对 象 ,可 以 使 用 下 面 的 表达 式 进行 访问 。 

{"one", "bwow "thres","four"}[2] // 返 回 列表 中 的 第 3 个 元 素 ,此 处 为 字符 串 "three" 

list.size // 访 问 list 中 元 素 的 个 数 ,list 为 一 个 Iist 对 象 

list.isEmpty // 刊 断 list 是 否 为 空 ,list 为 一 个 Iist 对 象 

list.iterator // 返 回 用 于 访问 list 的 iterator 对 象 
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3 Mep 
利用 OGNL 表达 式 创建 Map 对 象 的 方法 如 下 : 


# {key :value ,keY :values , .. keys :value, } 
例如 ,表达 式 
# {"one": "red", "two": "blue "three": "white"} 


创建 了 一 个 长 度 为 3 个 元 素 的 Map 对 象 , 元 素 类 型 为 String。 
以 下 是 利用 OGNL 访问 Map 对 象 的 例子 。 


# {"one":"red", "twon:rpluew "three":"white"} ["two"]  // 访 问 key= "two" 的 元 素 


map.three // 返 回 Mp 对 象 中 key=three 的 value, 此 处 为 "white" 
map["two"] // 返 回 Mp 对 象 中 key=two 的 元 素 ,此 处 为 "blue" 
map.size /判断 Map 是 否 为 空 


除了 上 述 访 问 集合 对 象 的 方法 外 ,OGNL 还 允许 利用 选择 表达 式 访问 集合 对 象 ,可 
以 使 用 的 运算 符 有 以 下 3 个 。 

(1) ?: 选择 符合 条 件 的 所 有 元 素 。 

(2)“^: 选择 符合 条 件 的 第 一 个 元 素 。 

(3) $ : 选择 符合 条 件 的 最 后 一 个 元 素 。 

例如 ,users 是 一 个 包含 了 User 对 象 的 列表 。 

#users.{ 强 this.age> 30)  ”// 返 回 所 有 年 龄 大 于 30 的 用 户 的 列表 

# users.{ 介 this.ages> 30}  ”// 返 回 年 龄 大 于 30 的 第 一 个 用 户 构 成 的 列表 。 如 果 没 有 
// 符 合 条 件 的 元 素 ,返回 一 个 空 列表 

#users.{$#this.age>30} ”// 返 回 年 龄 大 于 30 的 最 后 一 个 用 户 构成 的 列表 。 如 果 没 
// 有 符合 条 件 的 元 素 ,返回 一 个 空 列 表 


616 OGN 中 的 三 个 重要 符号 

在 Struts 2 中 使 用 OGNL 时 ,经 常会 用 到 符号 “#”“%” 和 “$$”。 

1.“# ”符号 

“#” 符 号 的 主要 作用 如 下 。 

(1) 用 于 访问 保存 在 Stack Context 中 的 对 象 。 当 一 个 对 象 object 保存 在 Stack 
Context 中 时 ,必须 使 用 “ #object” 的 形式 去 访问 。 

“#” 符 号 相当 于 ActionContext. getContext() 。 因 此 ,# session. msg 表达 式 相当 于 
调用 ActionContext. getContext(). getSession(). getAttribute("msg") 。 

(2) 用 于 过 滤 和 投影 (projecting) 集 合 。 例 如 : 


#users.{3# this.age> 30} 
# users.{?# this.age> 30}.{age} [0] 


(3) 用 来 构造 Map 对 象 集 合 。 例 如 : 


<s:radio list 啡 {1:' 男 2:" 女 "label= "性别 " name= "gender" /> 
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中 利用 “#” 符 号 构造 了 一 个 具有 两 个 Map 对 象 的 集合 ,并 利用 该 集合 充当 了 radio 标签 
的 数据 源 。 

2“%” 符 号 

在 为 Struts 2 标签 的 属性 赋值 时 ,除了 使 用 常量 外 ,还 可 以 使 用 OGNL 表达 式 。 通 
常 ,可 以 利用 *%{” 和 “)” 将 OGNL 表达 式 括 起 来 。 例 如 ,语句 

<s: property value— 鸣 {title}"/> 
告诉 Struts 2 将 title 的 值 作为 value 属性 的 值 。 

在 不 发 生 歧 义 的 情况 下 ,“%” 通 常 可 以 省 略 。 因 此 ,上 面 的 语句 等 价 于 

< 3: property value= "title"/> 

但 是 ,下 面 的 语句 利用 set 标签 定义 了 一 个 对 象 page( 值 为 10) ,并 将 其 保存 在 Stack 
Context 中 ,然后 在 a 标签 中 将 page 取出 ,计算 下 一 页 的 地 址 。 此 时 就 不 能 省 略 “%”, 即 
不 能 将 “%{#page 一 1)” 写 成 “{#page 一 1)”。 


< 3:3et name= "page" value= "10" jd "page"> < /s:set> 
< s:a href= "postDetail.action?page=%{#page- 1}"> 上 一 页 < /s:a> 


3“$ "运算 符 

(1) 在 配置 文件 中 使 用 OGNL 表达 式 访 问 Action 的 属性 。 例 如 : 

<action name= "login" class= "org.shops.action.LoginAction"> 

< result> /$ {folder}/welome.jsp< /result> 

< /action> 

(2) 当 在 国际 化 资源 文件 中 构造 的 消息 文本 中 使 用 了 OGNL 表达 式 时 ,需要 将 
OGNL 表达 式 用 “$ {” 和 “}” 括 起 来 。 例 如 : 

message=- 欢迎 5S{fusername] 登 录 系 统 ! 

详细 的 使 用 方法 将 在 后 面 的 国际 化 部 分 介绍 。 


62 标签 库 


621 使 用 标签 库 的 好 处 


在 早期 的 JSP 设计 中 ,通过 在 HTML 标签 中 嵌入 Java 脚本 来 生成 页 面 中 的 动态 内 
容 。 在 一 个 页 面 中 嵌入 过 多 的 脚本 片段 会 大 大 降低 程序 的 可 读 性 和 应 用 的 可 维护 性 。 
目前 ,在 大 型 的 应 用 开发 中 ,团队 分 工 比较 明确 ,业务 处 理 逻 辑 和 页 面 美工 设计 工作 由 不 
同 的 开发 人 员 承 担 ,页 面 美工 人 员 往 往 不 懂得 Java 语言 ,而 Java 程序 员 对 于 美工 的 知识 
也 比较 欠缺 。 因 此 , 原 有 的 JSP 页 面 设计 方式 无 法 适应 实际 的 开发 要 求 。 

JSP 标签 库 是 一 种 通过 JavaBean 生成 基于 XML 的 脚本 的 方法 。 通 过 定义 标签 ,可 
以 在 简单 的 标签 中 封装 比较 复杂 的 功能 。JSTL 标签 库 是 在 JSP 页 面 开发 中 出 现 最 早 的 
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标签 库 ,也 是 至 今 仍 被 很 多 Java 程序 员 热衷 的 标签 库 。 通 过 使 用 JSTL 标签 库 , 可 以 获 
得 以 下 好 处 。 

(1) 标签 的 应 用 比较 简单 ,任何 人 都 很 容易 使 用 ,很 容易 上 手 。 

(2) 通过 标签 来 表达 页 面 逻辑 ,可 以 避免 在 JSP 页 面 中 使 用 Java 代码 ,让 逻辑 与 显 
示 分 离 ,提高 JSP 的 可 维护 性 。 

(3) 通过 使 用 标签 ,有 利于 页 面 美工 人 员 和 Java 程序 员 进 行 团队 协作 开发 。 

(4) 标签 库 具 有 重用 性 ,一 旦 建立 起 来 ,就 可 以 在 今后 的 项 目 中 重复 使 用 。 

标签 库 几 乎 是 每 个 MVC 框架 的 重要 组 成 部 分 。 从 Struts 1 开始 ,到 Webwork 2、 
SpringMVC ,都 有 自己 定义 的 一 套 标签 库 。Struts 2 也 提供 了 大 量 的 标签 ,用 于 简化 表示 
层 的 设计 。 
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Struts 2 中 的 标签 分 为 通用 标签 和 UI 标签 两 大 类 。 其 中 ,通用 标签 包括 数据 标签 和 
控制 标签 两 类 。 数 据 标签 用 于 显示 Value Stack 中 的 数据 ,以 及 完成 国际 化 等 功能 ;控制 
标签 主要 用 于 实现 分 支 和 循环 ,完成 对 集合 的 迭代 。UI 标签 又 分 为 表单 标签 非 表 单 UI 
标签 和 Ajax 标签 三 类 。 表 单 标签 用 于 生成 html 元 素 的 标签 ; 非 表单 UI 标签 用 于 在 JSP 
页 面 中 显示 与 Action 有 关 的 消息 和 错误 ,显示 错误 校 验 信息 等 ;Ajax 标签 在 实现 时 调用 
了 DOJO 等 Ajax 框架 。Struts 2. 1 之 后 的 版 本 中 不 再 将 DOJO 作为 默认 的 JavaScript 
框架 ,这 里 不 介绍 这 部 分 标签 。 

要 想 在 JSP 页 面 中 使 用 Struts 2 的 标签 ,可 以 在 页 面 开 头 加 上 一 条 taglib 指令 , 方 
法 如 下 : 


< %@ taglib uri= "/struts- tags" prefix= "s" %> 


63 数据 标签 


631 debug 标签 


debug 标签 用 于 帮助 程序 员 进 行 调试 ,该 标签 在 页 面 上 生成 一 个 超级 链接 。 点 击 这 
个 链接 ,程序 员 可 以 查看 ActionContext 和 值 栈 中 所 有 能 访问 的 值 。 该 标签 没有 任何 属 
性 。debug 标签 显示 的 内 容 如 图 6-2 所 示 。 

建议 读者 在 学 习 后 面 的 各 个 数据 标签 时 ,利用 debug 标签 查看 每 个 标签 对 Value 
Stack 和 Stack Context 造成 了 哪些 影响 。 


632 property 标签 


property 标签 的 作用 是 输出 Value Stack 中 的 数据 。property 标签 的 主要 属性 如 
表 6-1 所 示 。 


Es Web 应 用 程序 开发 技术 一 JSP 十 Struts 2 


Er a 
€ 了 CO127.0.0.1:808 


Value Stack Contents 值 栈 中 的 内 容 


PropertyProperty 
ee Nane Value 
com opensymphony. wmork?. Defaul tTextProvider texts ull 


Stack Context 栈 上 下 文 的 内 容 


These items are available using the #ey notation 


Eey 
com opensymphony. xwork2. dispatcher. HttpServletRequest org. apache. struts2. dispatche: 


图 6-2 debug 标签 显示 的 内 容 


表 6-1 property 标签 的 主要 属性 


属性 名 | 是 否 必需 | 类 型 说 明 
li 否 站 进行 求 值 的 OGNL 表达 式 ,默认 值 为 top, 此 时 将 返回 Value Stack 
最 顶端 的 对 象 
default 否 String 当 value 为 空 时 的 默认 值 
escape 和 否 Boolean | 是 否 对 输出 内 容 中 的 html 特殊 字符 进行 转 义 。 默 认 值 为 true 
例如 : 


< s:property value= "userName" default= "游客 " /> 

property 标签 经 常用 于 在 JSP 页 面 中 输出 Action 属性 的 值 ,或 者 将 Action 属性 的 
值 组 装 到 其 他 标签 中 。 例 如 ， 

< img src= "images/head/< s:property value= "topic.user.head'/> " /> 
中 ,利用 property 标签 动态 地 获得 了 用 户 的 头像 。 

注意 escape 属性 的 用 法 。 例 如 ,一 个 留言 板 程序 在 用 户 留 言 页 面 可 能 使 用 了 一 个 
HTML 在 线 编辑 器 ,这 样 , 用 户 可 以 设置 留言 内 容 的 字体 颜色 ,甚至 添加 一 个 表格 。 显 
示 留 言 内 容 的 页 面 要 想 正确 显示 出 用 户 设置 的 字体 颜色 以 及 添加 的 表格 ,需要 将 显示 内 
容 的 property 标签 的 escape 属性 设置 为 false; 和 否则 ,用 户 只 能 看 到 一 堆 HTML 代码 。 


633 ”param 标 签 
param 标签 通常 用 做 其 他 标签 的 子 标签 ,为 其 他 标签 提供 运行 参数 。param 标签 的 
主要 属性 如 表 6-2 所 示 。 


表 6-2 param 标签 的 主要 属性 


属性 名 


是 否 必需 类 型 说 明 


name 


否 String 所 需 设置 参数 的 名 字 


value 


否 Object 所 需 设 置 参 数 的 值 


param 标签 有 两 种 用 法 。 
第 一 种 用 法 如 下 : 
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< 3:param name= "username"> zhangsan< /s:param> 


第 二 种 用 法 如 下 : 


< 3:param namer "username" valuer "zhangsan"> < /s:param> 

注意 : 上 述 两 种 用 法 不 完全 等 价 。 用 法 一 的 语义 是 将 字符 串 “zhangsan? 赋 值 给 参数 
username; 用 法 二 的 语义 是 将 对 象 zhangsan 的 值 赋值 给 参数 username, 如 果 对 象 
zhangsan 不 存在 , 则 参数 username 将 取 空 值 。 如 果 和 希望 利用 用 法 二 给 参数 username 赋 
值 为 字符 串 “zhangsan”, 则 需要 使 用 下 述 形式 。 


< s:param name= "username" value= "'zhangsan'"> < /s:param> 


再 举 一 个 例子 : 


< 3:param name= "age" value= "6+ 20"> < /s:param> 


该 语句 将 参数 age 赋值 为 26。 


634 action 标签 


action 标签 允许 程序 员 直 接 在 JSP 页 面 调用 一 个 Action。 在 调用 Action 时 ,可 以 使 
用 param 标签 向 Action 传递 参数 。 在 将 executeResult 属性 指定 为 true 时 ,可 以 将 
Action 对 应 的 结果 视图 也 包含 到 本 页 面 中 。action 标签 的 主要 属性 如 表 6-3 所 示 。 


表 6-3 action 标签 的 主要 属性 


属 性 名 是 否 必需 | 类 型 说 明 
name 是 String 要 执行 的 Action 的 名 字 ,不 能 写 扩展 名 
namespace 否 String 要 执行 的 Action 的 命名 空间 
ER 否 5 为 true 时 ,执行 Action 的 结果 码 对 应 的 result。 默 认 值 
为 false 
ignoreContextParams 否 Boolean ” ee ' 页 面 的 请 求 参数 将 传递 给 Action。 默 认 值 
var 否 String “| 允许 用 户 根 据 该 属性 引用 var 


下 面 举 一 个 关于 action 标签 的 例子 。 有 个 ActionTagAction 类 ,如 代码 6-1 所 示 。 


代码 6-1 ActionTagAction. java 


Public class RctionTagacticn extends ActicnSupport { 
Private String message; 


// 省 略 message 属 性 的 get 和 set 方 法 


Public String execute () throws Excepticnf 
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if (mll==message) 
TESSsage= "How are YOU2"7 
( Map) ActicnContext .getContext () .get ("request")) 
-Put ("message", message); 
Teturn SUOCESS; 
§ 


Public String test () throws Exosption{ 
( Map)ActionContext .getContext () .get ("request")) 
.put ("message", "现在 执行 的 是 test 0)"); 


retum SUDOCESS; 


3 


代码 6-2 给 出 的 页 面 actionTag. jsp 利用 action 标签 对 ActionTagAction 进行 了 调用 。 
代码 6-2 actionTag. jsp 的 片段 


<h3> 执 行 actionTag, 利 用 param 向 ction 传 递 参数 ,并 包含 result 结果 < /h3> 
<s:acticn name= "actionTag" namespace= "/" executeResult= "true"> 
< 3s:param name= "message"> Hello World!< /s:parar> 
< /s:action> 
< 3:property value= # attr.message"/> 


<h3> 执 行 actionTag, 禁 止 将 页 面 请 求 参数 传递 给 Acticn, 不 包含 result 结果 < /h3> 
<s:acticon name= "actionTag" namespace= "/" ignoreContextParams= "true"> 

< /s:action> 

< 3:property value= "# attr.message"/> 


<h3> 执 行 actionTeg, 不 包含 result 结果 < /h3> 
< 3s:actian name= "actionTag" namespace= "/" > 

< /s:action> 

< s:property value= # attr.message"/> 


<h3> 执 行 actionTag 中 的 方法 test, 不 包含 result 结果 < /h3> 
< s:action name= "actionTag!test" namespace= "/" > 

< /s:action> 

< s:property value= 只 attr.message"/> 


在 上 述 页 面 中 ,通过 param 标签 向 Action 传递 参数 ,指定 executeResult 属性 ,决定 
是 否 将 处 理 结果 的 页 面包 含 到 当前 页 面 中 。 通 过 指定 ignoreContextParams, 禁止 向 
Action 类 传递 页 面 的 请 求 参 数 , 通 过 动态 调用 执行 Action 的 非 execute() 方 法 。 程 序 执 
行 结果 如 图 6-3 所 示 。 


635 bean 标签 
bean 标签 用 于 实例 化 一 个 JavaBean 对 象 。 在 实例 化 时 ,可 以 使 用 param 标签 为 
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Ee 
€ 3 {O127.0.0.1:3 c ! 家 


执行 actionTag， 利 用 param 向 Action 传 递 参数 ， 并 包含 rsult 结 果 


执行 成 功 ! Hello World! 
执行 actionTag， 禁 止 将 页 面 请 求 参数 传递 给 Action， 不 包含 Yesult 结 果 


How are you? 
执行 actionTag， 不 包含 result 结 果 注意 请 求 参 数 
hello! 

执行 actionTag 中 的 方法 test， 不 包含 result 结 果 

现在 执行 的 是 test () Session: hello! 


图 6-3 action 标签 的 使 用 


JavaBean 对 象 的 属性 赋值 。JavaBean 类 的 定义 必须 符合 规范 ,也 就 是 说 ,所 有 需要 使 用 
param 标签 赋值 的 属性 必须 定义 set 方法 ,所 有 需要 在 JSP 页 面 中 取 值 的 属性 必须 给 出 
get 方法 。 表 6-4 给 出 了 常用 的 bean 标签 的 属性 。 


表 6-4 ”bean 标签 的 属性 


属性 名 是 否 必需 类 型 说 明 
name 是 String 要 实例 化 的 JavaBean 完整 的 类 名 
var 否 String 用 于 引用 该 对 象 


实例 化 的 JavaBean 将 会 被 压 人 到 Value Stack 的 顶部 ,在 bean 标签 内 部 可 以 访问 
该 对 象 。 当 bean 标签 结束 时 ,实例 化 的 对 象 将 从 Value Stack 删除 。 要 想 在 bean 标签 
结束 之 后 仍然 可 以 访问 实例 化 的 对 象 ,需要 用 到 var 属性 。 当 指定 var 属性 时 ， 
JavaBean 在 保存 到 Value Stack 的 同时 被 保存 到 Stack Context 中 。 在 bean 标签 结束 
时 ,保存 在 Stack Context 中 的 对 象 不 会 被 删除 ,可 以 通过 var 属性 访问 ,但 是 需要 使 用 
“# ”标记 。 
下 面 的 代码 利用 bean 标签 实例 化 了 一 个 Note 的 对 象 ,并 利用 var 在 bean 标签 结束 
后 访问 了 对 象 的 title 属性 。 
< s:bean name= "exanple.Mdel.Note" var= "note"> 
<param name= "title"> 请 教 一 个 bean 标 签 的 问题 < /param> 
<param name= "oontent"> 能 介绍 一 下 bean 标 签 的 var 属 性 吗 < /param> 
</s:bean> 
< 3:property value= "# note.title"/> 
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set 标签 用 于 将 表达 式 的 值 赋 给 指定 范围 内 的 变量 。 简 单 地 说 ,set 标签 就 是 定义 一 
个 新 的 变量 。 表 6-5 给 出 了 set 标签 常用 的 属性 。 
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表 6-5 set 标 签 常 用 的 属性 


属性 名 是 否 必需 类 型 说 明 
name 是 String | 变量 的 名 字 

a 设置 给 变量 的 值 ,可 以 是 常量 ,也 可 以 是 OGNL 表达 式 。 默 认 
value 否 String 


时 ,将 value Stack 栈 顶 对 象 赋值 给 变量 


变量 的 范围 。 可 选 值 为 application、request、 session、page 和 
action。 默 认 值 为 action。 


scope 否 String 


一 个 对 象 在 ONGL 上 的 访问 层次 较 深 时 ,例如 划 request. note. user. userName, 就 可 
以 使 用 set 标签 将 它 定义 成 一 个 变量 ,以 保证 在 多 次 引用 它 的 时 候 更 方便 。set 标签 定义 
的 变量 将 保存 到 Stack Context 中 。 当 scope 取 值 为 action 时 ,变量 将 同时 被 保存 到 
request 范围 。 

代码 6-3 演示 了 set 标签 的 用 法 。 


代码 6-3 ”set 标签 的 用 法 


<h3> 将 action 的 属性 值 保 存 到 变量 title 中 ,并 输出 < /h3> 
<s:set name= "title" value= "note.title"/> 
< s:property value= 啡 title"/><br/> 


<h3> 从 request 请 求 范围 中 输出 title< /h3> 
< s:property value= # request.title"/> 


<h3> 将 常量 hahaha 保 存 到 sessicn 范围 < /h3> 
< s:set name= "test" value= "'hahaha'" scope= "session"/> 
< s:property valuer "# session.test"/> 


<h3> 求 表达 式 的 值 < /h3> 

< s:set var= "page" value= "1"/> 

当前 页 : < s:property value= 啡 page"/> <br> 
< s:set var= "page" value= # paget 1"/> 

下 一 页 : < s:property value= 哇 page"/> 


注意 上 例 中 对 于 变量 的 操作 。 图 6-4 给 出 了 运行 时 的 输出 效果 。 
637 push 标 签 


push 标签 用 于 将 一 个 值 讨 人 Value Stack。 当 一 个 对 象 访问 层次 过 深 的 时 候 , 可 以 
用 push 标签 来 做 访问 的 简化 。 和 set 标签 不 同 ,push 标签 把 指定 的 对 象 放 到 Value 
Stack 的 栈 顶 ,而 set 标签 将 值 放 到 Stack Context 中 。 

push 标签 的 一 个 特性 是 其 起 始 标签 把 值 压 人 栈 中 ,结束 标签 将 该 值 弹出 。 表 6-6 给 
出 了 push 标签 的 属性 。 
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园 =+t es ne 
和 COliz.ool:so ion 


将 Action 的 属性 值 保 存 到 变量 title 中 ， 并 输出 


2011 年 伦敦 丘 运 会 正在 百 开 ! 
从 request 请 求 范围 中 输出 title 


2011 年 伦敦 喘 运 会 正在 百 开 ! 

将 常量 hahaha 保 存 到 session 范 围 
hahaha 

求 表达 式 的 值 


图 6-4 ”set 标签 运行 时 的 输出 效果 


表 6-6 push 标签 的 属性 
属性 名 是 否 必需 类 型 说 明 
value 是 String 用 来 指定 放 到 value stack 栈 顶 的 对 象 


代码 6-4 演示 了 push 标签 的 用 法 。 
代码 6-4 ”push 标签 的 用 法 


<h3> 利 用 push 标 签 简化 对 象 的 访问 < /3> 
<s:bean name= "exanple.Model.Note" var= "note"> 
<param name= "title"> 请 教 一 个 问题 < /param> <br/> 
<param name= "content"> push 标 签 和 set 标签 有 什么 区 别 吗 < /param> 
< /s:bean> 
< s:push value= 啡 note"> 
< 3s:property value= # title"/> <br/> 
< 3:property value= # title"/> 
< /s:push> 


图 6-5 给 出 了 push 标签 的 运行 效果 。 
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利用 push 标 签 简化 对 象 的 访问 


请 教 一 个 问题 _ 
push 标 签 和 set 标 签 有 什么 区 别 吗 


图 6-5 ”push 标签 的 运行 效果 
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url 标签 用 于 动态 地 创建 一 个 URL。 可 以 利用 param 标签 为 URL 提供 附加 参数 。 
url 标签 的 属性 很 多 , 表 6-7 给 出 了 常用 的 一 些 属性 。 
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表 6-7 url 标签 的 常用 属性 


属 性 名 | 是 否 必 需 | 类 型 说 明 

和 否 局 指定 用 生成 哪 一 个 Action 的 URL。 省 略 时 ,将 使 用 value 
action ring 的 值 作为 URL 地 址 

1 香 Stri 指定 用 生成 URL 的 地 址 值 。 省 略 时 ,将 使 用 action 的 值 作 
A "8 | 为 URL 地 址 
anchor 否 String 指定 URL 的 锚 点 
s 指定 是 否 包含 请 求 参 数 。 默 认 值 为 get, 可 选 值 为 none get 
includeParams 否 String 和 all 
includeContext 否 Boolean | 是 否 将 当前 上 下 文 路 径 包 含 进 URL。 默 认 值 为 true 
namespace 否 String 指定 所 用 Action 的 命名 空间 
method 否 String 指定 要 执行 Action 的 方法 
scheme 否 String 指定 URL 使 用 的 协议 
escapeemp 否 Boolean | 是 否 将 “8&.” 转 义 为 *“&amp”。 默 认 值 为 true 
encode 否 Boolean 是 否 将 URL 编码 。 默 认 值 为 true 
id 否 Strin, 在 指定 了 该 值 后 , URL 不 会 输出 到 页 面 ,而 是 保存 在 
8。 | OGNL 上 下 文中 ,以 后 可 以 使 用 a 标签 引用 


当 value 和 action 属性 同时 指定 时 ,优先 使 用 的 是 value 属性 的 值 。 如 果 两 个 属性 的 
值 都 没有 指定 , 则 将 使 用 当前 页 面 的 URL 作为 地 址 值 。 

如 果 includeParams 属性 的 值 为 get, 在 生成 的 URL 中 将 包含 GET 请 求 提 交 的 参 
数 ; 如 果 值 为 all, 则 在 生成 的 URL 中 会 包含 GET 请 求 和 POST 请 求 提交 的 参数 ;如 果 
值 为 none, 则 在 生成 的 URL 中 不 会 包含 任何 请 求 参 数 。 

a 标签 用 于 创建 HTML 中 的 标签 二 a> , 它 支持 url 标签 的 所 有 属性 。 除 此 之 外 ,还 
支持 用 于 指示 超级 链接 地 址 的 属性 href 和 绝 大 多 数 与 标签 二 a 之 有 关 的 属性 和 事件 。 

代码 6-5 演示 了 url 标签 和 a 标签 的 用 法 。 


代码 6-5 url 标签 和 a 标签 的 用 法 


<h3> 使 用 param 向 url 标 签 传递 参数 ,使 用 action 属 性 指定 地 址 值 < /h3> 


< s:url action= "actianTag> 


< s:param name= "message"> Hello World!< /s:param> 


</s:url> 


<h3> 使 用 param 向 url 标签 传 递 参数 ,使 用 value 属 性 指定 地 址 值 < /h3> 


< s:url value= "actimTag> 


< 3:param name= "message"> Hello World!< /s:param> 


</s:url> 


<h3> 使 用 这 属性 ,不 显示 生成 的 EL 字符 串 < /h3> 


< s:url value= "actinTag" id "myUr1"> 


< s:param namer "message"> Hello World!< /s:param> 


</s:url> 


<h3> 利 用 标签 a 引用 url 标 签 生成 的 URI< /h3> 
<s:a href="8fmyUrlj" > 动态 生成 的 超级 链接 < /s:a> 
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图 6-6 给 出 了 对 应 的 运行 结果 ,读者 可 以 自己 尝试 着 分 析 一 下 。 


EEC 


€ 3 © [O127.0.0.1:8080/notes/06/uriTag. isp 亦 | 六 
使 用 param 向 ur1 标 签 传递 参数 ， 使 用 action 属 性 指定 地 址 值 
/rotes/06/actionTas. action?measase=HellotWorl dX21 


使 用 param 向 ur1 标 签 传递 参数 ， 使 用 value 属 性 指定 地 址 值 


actionTag ?message=HellotWorld%21 
使 用 id 属性 , 不 显示 生成 的 URL 字 符 圳 
利用 标签 a 引用 ur1 标 签 生成 的 URL 

动态 生成 的 超级 链接 上 一 页 


图 6-6 url 标签 和 a 标签 的 运行 结果 


639 incude 标 签 
include 标签 用 于 把 其 他 页 面 或 Servlet 包含 到 当前 的 页 面 中 。include 标签 和 JSP 
的 标准 动作 二 jsp:include 二 非常 类 似 ,都 是 在 运行 期 间 将 被 包含 的 页 面 引入 到 本 页 。 在 
包含 页 面 时 ,可 以 在 include 标签 内 利用 param 标签 向 被 包含 的 页 面 传递 请 求 参 数 。 
需要 注意 的 是 ,包含 页 面 和 被 包含 页 面 是 相互 独立 的 ,不 能 共享 变量 。 表 6-8 给 出 了 
include 标签 的 属性 。 
表 6-8 include 标签 的 属性 


属性 名 是 否 必需 类 型 说 明 
value 是 String 被 包含 的 JSP 或 Servlet 


代码 6-6 给 了 include 标签 的 用 法 。 
代码 6-6 include 标签 的 用 法 


< !-- includeTeg.jsp --> 
<h3> 使 用 include 标 签 包含 pagel.jsp < /h3> 
<s:include value= "pagel.jsp> < /s:include> 


<h3> 使 用 include 标 签 包含 page2.jsp < /h3> 
< 3:include value= "Page2.7s3p> 

< s:param name= "mesasage"> 欢 迎 学 习 Struts2!< /s:param 
< /s:include> 


<!--pagel.jsp --> 
< $@ page language= "java" pageEnooding= "UIF- 8'%> 
这 是 Pagel! 


< !-- Fage2.jsp --> 
< $@ page language= "java" pageEnooding= "DTF- 8'%> 
这 是 Fage2!<br/> 
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< 上 -利用 所 表达 式 输出 传递 过 来 的 参数 一 > 
$ {param.message} 


注意 : 在 页 面 page2. jsp 中 不 能 使 用 property 标签 输出 传递 过 来 的 请 求 参 数 
message。 如 果 需 要 输出 的 话 , 则 可 以 使 用 JSP 的 el 表达 式 输出 。 
图 6-7 给 出 了 代码 6-6 运行 的 效果 。 
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使 用 include 标 签 包含 pagel. jsp 


这 是 Pagell 
使 用 include 标 签 包 含 page2. jsp 


这 是 Page21 
欢迎 学 习 Struts2! 


图 6-7 include 标签 的 运行 效果 


6310 date 标签 
date 标签 用 于 格式 化 输出 日 期 型 数据 ,也 可 以 输出 当前 日 期 和 指定 日 期 之 间 的 时 
间 差 。 


表 6-9 给 出 了 date 标签 常用 的 属性 。 
表 6-9 date 标签 常用 的 属性 


属性 名 | 是 否 必需 | 类 型 说 明 
name 是 String 需要 格式 化 的 日 期 对 象 
format String 指定 日 期 的 格式 化 样式 


否 
be 否 lea 是 否 显 示 当 前 时 间 与 指定 时 间 的 差 。 如 果 设 置 为 true, 则 不 再 显 
示 指 定时 间 , 只 显示 当前 时 间 与 指定 时 间 的 差 。 默 认 值 为 false 
否 


String 用 来 引用 被 保存 在 Stack Context 的 日 期 对 象 


当 属 性 nice 的 值 设置 为 false 时 ,format 属性 将 不 会 起 作用 。 如 果 nice 属性 和 
format 属性 都 没有 设置 , 则 date 标签 将 从 国际 化 资源 包 中 查找 struts. date. format 键 。 
找到 后 ,利用 该 键 的 值 作 为 日 期 的 格式 化 样式 :如果 找 不 到 ,就 采用 DateFormat. 
MEDIUM 格式 化 样式 。 有 关 国 际 化 的 问题 ,将 在 后 面 的 章节 讲述 。 

代码 6-7 演示 了 date 标签 的 用 法 。 


代码 6-7 date 标签 的 用 法 


< 
Calendar c= Calendar.getInstanoe (); 
Cc.set (Calendar .MONTH, c.get (Calendar .MONTH)+ 1); 
pageContext .setAttribute ("calendar",c); 

$> 
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<h3> 格 式 化 输出 date< /h3> 
< s:date name= 啡 attr.calencdar" format="yyyy 年 MI 月 四 日 " /><br/> 


<h3> 无 格式 化 输出 datec /h3> 
< s:date name= 啡 attr.calencdar" /><br/> 


<h3> 用 nice 输 出 当前 日 期 和 calendar 的 差 < /h3> 
< s:date name= 啡 attr.calendar" nioe= "true" /> 


图 6-8 为 上 述 代码 的 运行 效果 。 
国 ste ts ernle 
© 30 127.0.0.1:808 


格式 化 输出 date 
2012 年 09 月 04 日 


无 格式 化 输出 date 
2012-9-4 11:05:20 
用 nice 输 出 当前 日 期 和 calendar 的 差 


in 30 days，23 hours 


图 6-8 date 标 签 的 运行 效果 


64 控制 标签 


Struts 2 的 控制 标签 主要 关注 程序 的 运行 流程 。 例 如 ,利用 if/elseif/else 标签 进行 
分 支 控制 ,利用 iterator 标签 实现 对 集合 数据 的 循环 控制 等 。 


641 if,elsef 和 dse 标 签 
if、elseif 和 else 标签 用 于 对 给 定 的 条 件 进行 测试 ,类 似 于 Java 语言 中 的 if、elseif 和 
else 关键 字 。if 标签 可 以 单独 使 用 ,也 可 以 和 一 个 或 多 个 elseif 标签 ,或 者 和 一 个 else 标 
签 一 起 使 用 。elseif 标签 和 else 标签 不 能 脱离 i{f 标签 单独 使 用 。if 和 elseif 标签 都 具有 
一 个 属性 test, 如 表 6-10 所 示 。 
表 6-10 if 和 elseif 标签 的 属性 


属性 名 是 否 必 需 类 型 说 明 
test 是 Boolean 测试 条 件 


代码 6-8 演示 了 if elseif 和 else 标签 的 用 法 。 
代码 6-8 ”这 、elseif 和 else 标签 的 用 法 


<h3> 测 试 请 求 参数 输入 的 数据 < /hb3> 
< s:set name= "number" value= "4 parameters.number[0]"> < /s:set> 
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<s:if test=# nnber> 0> 
您 输入 的 是 一 个 正 数 ! 
</orits 
< s:elseif test=# nnber== 0"> 
您 输入 的 数 等 于 0! 
</s:elseif> 
<s:else> 
您 输入 的 是 一 个 负数 ! 


</s:else> 


<h3> 测 试用 户 是 否 登 录 < /h3> 
< 3:if test= 叶 session.user==nu11"> 
您 尚未 <s:a href= "login.action"> 登录 < /s:a>! 


</s:if> 

<s:else> 
欢迎 您 ! 

</s:else> 


在 浏览 器 中 输入 “http ://127. 0. 0.1:8080/notes/06VifTag. jsp?number 王 一 5”, 可 以 
看 到 如 图 6-9 所 示 的 效果 。 


国 if/aseis/dse tag exeix 


€ > O127.0.0.1:8080/r 
测试 请 求 参 数 输入 的 数据 


您 输入 的 是 一 个 负数 | 
测试 用 户 是 否 登录 
您 尚未 登录 | 


6-9 ”这 ,elseif 和 else 标签 的 运行 效果 


642 iterator 标签 


iterator 标签 是 控制 标签 中 最 重要 的 。 可 以 通过 iterator 标签 遍历 一 个 数组 、Set、 List、 
Map 和 Iterator 等 集合 对 象 。 在 迭代 时 ,iterator 标签 会 把 要 迭代 的 集合 对 象 中 的 每 一 个 元 
素 依 次 压 和 人 Value Stack 和 弹出 Value Stack。 表 6-11 给 出 了 iterator 标签 常用 的 属性 。 


表 6-11 iterator 标签 常用 的 属性 


属性 名 | 是 否 必需 | 类 型 说 明 

begin 否 Integer 指定 迭代 的 起 始 下 标 。 默 认 值 为 0 

end 否 Integer | 指定 迭代 的 终止 下 标 

status 否 Boolean | 当 指定 该 值 时 将 创建 一 个 IteratorStatus 实例 。 默 认 值 为 false 
step 否 Integer | 指定 迭代 步 长 。 默 认 值 为 1 

value 否 String 指定 需要 迭代 的 集合 对 象 

var 否 String 用 于 引用 集合 对 象 中 的 当前 元 素 
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当 指 定 了 status 属性 时 ,将 创建 一 个 IteratorStatus 的 对 象 ,该 对 象 保存 到 Stack 
Context 中 。 利 用 IteratorStatus 可 以 实现 获得 更 多 与 迭代 相关 的 信息 , 表 6-12 给 出 了 该 
对 象 的 属性 。 


表 6-12 IteratorStatus 对 象 的 属性 


属性 名 类 型 说 明 

index Integer 正在 迭代 的 元 素 的 下 标 

count Integer 已 经 迭代 的 元 素 的 个 数 

first Boolean 当前 被 迭代 的 元 素 是 不 是 第 一 个 元 素 
last Boolean 当前 被 迭代 的 元 素 是 不 是 最 后 一 个 元 素 
even Boolean 当前 被 迭代 的 元 素 是 不 是 偶数 

odd Boolean 当前 被 迭代 的 元 素 是 不 是 奇数 


下 面 通过 例子 详细 讲述 iterator 标签 的 用 法 。 首 先 ,创建 一 个 IteratorAction 类 ,在 
该 类 中 封装 了 一 个 关于 User 对 象 的 List, 如 代码 6-9 所 示 。 


代码 6-9 IteratorAction. java 


< 上 --User.java --> 
public class User { 


Private int userId; // 用 户 耳 
private String usernamey // 用 户 名 
Private String password; /密码 


// 省 略 了 usemame、password 属 性 的 get 和 set 方 法 
} 


< !-- IteratorActian.java -一 > 
Public class IteratorAction extends ActionSupport { 
Private List< User> users; 
public List< User> getUsers() { 
retum users; 
} 


Public String execute(){ 
Users= new ArrayList< User> (); 
for(int i=0;i< 5;i++){ 
User user= new User (); 
User.setUserName ("user"+ (i+1)); 
user.setPassword ("password"™t (i+1)); 


Users.add (user); 
} 
Teturn SUOCESS; 
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接 下 来 编写 IteratorAction 的 结果 页 面 iteratorTag. jsp, 如 代码 6-10 所 示 。 
代码 6-10 ”结果 页 面 iteratorTag. jsp 


<h9> 和 迭代 输出 Tist 对 象 ,使 用 status 和 var 属 性 < /h3> 
< table border= "1" width= "300"> 
<tr> 

<t 中 序号 < /to> 

<t 中 用 户 名 < /to> 

<t 中 密码 < /to> 

</tr> 

< s:iterator value= "Users" status= "st" var= "user"> 

< 3:if test="# st.odd"> 
< tr style= "background:# efefef"> 

</s:it> 
<s:else> 
<tr> 
</s:else> 
<td> < s:property value=# st.indext 1"/>< /td> 
< to> < s:property value= 啡 User.userName"/>< /td> 
<td < s:property value= "# user.password"/> < /td> 
</tr> 

< /s:iterator> 

< /table> 


<h3> 和 迭代 输出 List, 使 用 begin 和 end 属 性 < /h3> 

< s:iterator value= "users" begin= "]" end= "4" var= "user2" > 
< s:property value= "# user2.userName"/> 

< /s:iterator> 


<h3> 和 迭代 输出 Map< /h3> 

< s:iterator value= # {'one':'red' 'two':'blue', 'three':'white'}"> 
< 3:property/> 

< /s:iterator> 


<h3> 和 迭代 Map, 分 别 输出 key 和 value< /h3> 

< s:iterator value= # {'one':'red', 'two': 'blue', 'three': 'white'}"> 
< s:property value= "key"/> :< s:property value= "value"/> 

< /s:iterator> 


注意 : 在 使 用 var 属性 后 ,被 迭代 的 集合 对 象 会 保存 到 Stack Context 中 ,因此 在 利 
用 var 引用 当前 迭代 元 素 时 ,一 定 要 使 用 “ 提 ” 符 号 。 

图 6-10 给 出 了 上 述 例 子 的 演示 效果 。 

iterator 标签 还 可 以 模拟 Java 语言 中 的 for 循环 。 例 如 ,下 面 的 语句 循环 输出 10 行 
字符 串 “Hello”。 

< 3:iterator beginrr "1" end "10"> 

Hello<br/> 
< /s:iterator> 
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Fe 
€ 3C | O127.0.0.1:8080/notes/06/iteratorTag. actia | 


送 代 输出 List 对 和 象 ， 使 用 Status 和 var 属 性 


序号 座 码 
[passwordl 
lpassword2 


assword3 


[password4 
assword5 


迭代 输出 List, 使 用 begin 和 end 属 性 
user2 user3 userd user5 

和 兴 代 输出 Map 

one=red two=blue three=white 

迁 代 Map， 分 别 输出 key 和 value 


one:red two:blue three:white 


图 6-10 iterator 标签 的 运行 效果 


643 append 标 签 和 merge 标 签 


append 标签 和 merge 标签 都 是 用 于 将 多 个 集合 对 象 组 合成 一 个 新 的 集合 对 象 , 二 者 
的 区 别 在 于 合并 后 的 集合 中 元 素 的 顺序 不 同 。 

假设 有 两 个 集合 对 象 A 和 B, 每 个 对 象 包括 3 个 元 素 。 使 用 append 标签 组 成 的 新 
对 象 中 的 元 素 如 下 (注意 顺序 ) ， 

(1) A 的 第 一 个 元 素 

(2) B 的 第 一 个 元 素 

(3) A 的 第 二 个 元 素 

(4) B 的 第 二 个 元 素 

(5) A 的 第 三 个 元 素 

(6) B 的 第 三 个 元 素 

使 用 merge 标签 组 成 的 新 对 象 中 的 元 素 如 下 (注意 顺序 ) : 

(1) A 的 第 一 个 元 素 

(2) A 的 第 二 个 元 素 

(3) A 的 第 三 个 元 素 

(4) B 的 第 一 个 元 素 

(5) B 的 第 二 个 元 素 

(6) B 的 第 三 个 元 素 

append 标签 和 merge 标签 具有 相同 的 属性 ,如 表 6-13 所 示 。 
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表 6-13 append 标签 和 merge 标签 的 属性 
属性 名 是 否 必需 类 型 说 明 


用 于 引用 组 合 后 的 集合 对 象 。 指 定 了 该 属性 后 ,合并 后 的 集合 


WE 否 Shing 将 放 入 Stack Context 


代码 6-11 演示 了 append 标签 和 merge 标签 的 用 法 。 
代码 6-11 append 标签 和 merge 标签 的 用 法 


<s:set var= "listl" value= "{'one', 'two', 'three'}"> < /s:set> 
< s:set var= list2" value= "{"red', "blue'}"> < /s:set> 


<h3> 用 apgpend 将 多 个 列表 组 合 在 一 起 迭代 < /h3> 
< s:append var= "allList1"> 

< s:param value= "# list1"> < /s:param> 

< s:param value= "# list2"> < /s:param> 
</s:append> 


<s:iterator value= 啡 al11Listl" > 
< s:property/> 
< /s:iterator> 


<h3> 用 merge 将 多 个 列表 组 合 在 一 起 迭代 < /h3> 
< simerge var= "allList2"> 

< s:param value= "# listl"> < /s:paran> 

< s:param value= "# list2"> < /s:param> 
< /s:merge> 


< s:iterator value= "%{#alllList2}" > 
< s:property/> 
< /s:iterator> 


读者 可 自行 分 析 上 述 代码 在 浏览 器 中 的 输出 结果 。 
644 ”generaor 标签 


generator 标签 用 于 将 一 个 字符 串 拆 分 成 若干 个 字符 串 构成 的 集合 ,可 以 利用 
iterator 标签 对 拆 分 结果 和 迭代 输出 。generator 标签 的 属性 如 表 6-14 所 示 。 


表 6-14 ”generator 标签 的 属性 


属性 名 是 否 必需 类 型 说 明 
val 是 String 要 拆 分 的 字符 串 
separator 是 String 拆 分 时 的 分 隔 符 
count 否 Integer 拆 分 后 的 集合 中 只 容纳 前 count 个 字符 串 
用 于 设置 自 定义 的 Converter 类 ,该 类 必须 实现 接口 
converter 否 Converter . 
org. apache. struts2. util. IteratorGenerator. Converter 
we 否 Su 用 于 引用 组 合 后 的 集合 对 象 。 指 定 了 该 属性 后 ,合并 后 
Tng | 的 集合 将 放 人 Page Context 
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代码 6-12 演示 了 generator 标签 的 用 法 。 
代码 6-12 ”generator 标签 的 用 法 


<h3> 利 用 generator 拆 分 字符 串 ,在 内 部 用 iterator 和 迭代 输出 < /h3> 
<s:generator val= 吕 {"'red,blue,green,black'}" separator= 
< s:iterator> 
< s:property /><br/> 
< /s:iterator> 
< /3:generator> 


<h3> 利 用 generator 拆 分 成 3 个 字符 串 , 在 外 部 用 iterator 迭代 输出 < /h3> 
< s:generator val= "%{'red,blue, green,black'}" separator="," cont= "3" 
Var=" /> 


< s:iterator value= 啡 on> 
< s:property /><br/> 
< /s:iterator> 


<h3> 自 定义 Converter 拆 分 字符 串 < /h3> 
< 3:generator val= %{'red,blue, green,black'}" separator="," 
Converter= "$% {myConverter}"> 
< s:iterator> 
< s:property /><br/> 
< /s:iterator> 
< /3:generator> 


代码 中 的 最 后 一 个 例子 用 到 了 一 个 自 定义 的 Converter 转换 器 ,将 其 定义 在 
GeneratorTagAction. java 中 。 该 Converter 用 方 括号 将 拆 分 得 到 的 字符 串 括 起 来 ,如 代 
码 6-13 所 示 。 


代码 6-13 ”GeneratorTagAction. java 中 定义 Converter 


Pblic class GeneratorTagacticn extends ActionSupport { 
private Converter myConverter; 
Public Converter getMyConverter() { 
return new Converter() { 
public Cbject convert (String value) throws Exosption { 
retum "[" +value + "]"; 


} 


public String execute () throws Exoeption { 
retum SUOCESS; 
3 
} 


在 浏览 器 中 查看 上 述 例子 ,运行 效果 如 图 6-11 所 示 。 
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国 senerator tag exanple 


< CC | @ 127.0.0.1:8080/notes/06/generatorTag. acti' 容 | M 
利用 generator 拆 分 字符 串 ， 在 内 部 用 iterator 送 代 输 
出 


red 
blue 
green 
black 


利用 generator 拆 分 成 3 个 字符 串 ， 在 外 部 用 iterator 


送 代 输出 


red 
blue 
green 


自 定义 Converter 拆 分 字符 串 


[red] 
[blue] 
[ereen] 
[black] 


图 6-11 generator 标签 的 运行 效果 


645 subsdt 标 签 


subset 标签 用 于 获取 指定 集合 的 子 集合 。subset 标签 的 属性 如 表 6-15 所 示 。 
表 6-15 subset 标签 的 属性 


属性 名 | 是 否 必需 类 型 说 明 
i 否 Collection、Map、Enumeration、| 指定 源 集合 。 缺 省 时 , 取 Value Stack 的 栈 顶 元 
和 Iterator 或 Array 素 作 为 源 集合 
a 否 指定 从 源 集合 的 第 几 个 元 素 开 始 截取 ,0 代表 
第 一 个 元 素 
count 否 Integer 截取 的 元 素 的 总 数 
用 于 设置 自 定 义 的 Decider 类 (实现 org. 
decider 否 Decider apache. struts2. util. SubsetIteratorFilter. 
Decider 接口 ) 
用 于 引用 截取 后 的 集合 对 象 。 指 定 该 属性 后 ， 
Var 否 String 


代码 6-14 演示 了 subset 标签 的 用 法 。 
代码 6-14 ”subset 标签 的 用 法 


截取 后 的 集合 将 放 入 Page Context 


< s:bean var= "myDecider" name= "exanple.Decider.0ddDecider"> < /s:bean> 
< s:set var= "myList" value= "{"1','2', '3','4','5', '6'}"> < /s:set> 


<h3> 利 用 sibset 从 列表 中 截取 子 集 ,起 始 索引 为 2, 截 取 3 个 元 素 < /h3> 


< s:subset source= "myList" start= "2" count= "3"> 
< s:iterator> 


< s:property /> 
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< /s:iterator> 
</s:subset> 


<h3> 利 用 var 属 性 将 截取 的 子 集 保存 到 pageContext 中 < /h3> 
< s:subset sourcer "myList" count= "3" var= "subset"> < /3:3ubset> 
< 
Tterator i= (Tterator) pageContext..getAttribute ("subset"); 
while(i.hasNezt ()) { 
out .print (inext ()+ "gnbsp; "); 
} 
%> 


<h3> 自 定义 Deciger, 获 取 列表 中 的 奇数 < /h3> 
< s:subeet souroe= "myList" decider= "imyDecider"> 
< 3:iterator> 
< s:property /> 
< /s:iterator> 
< /s:subset> 


代码 中 的 最 后 一 个 例子 使 用 一 个 自 定义 的 Decider 从 列表 中 取出 所 有 的 奇数 。 代 
码 6-15 给 出 了 自 定义 的 Decider。 


代码 6-15 OQddDecider. java 


import org.apache.struts2.util.SubsetTIteratorFilter.Decider; 


Public class OddDecider implements Decider { 
Public boolean decide (Cbject element) throws Exosption { 
String value= element .toString(); 
if (Integer.parseInt (value)®2!= 0) 
retum true; 
retum false; 


} 


在 浏览 器 中 查看 上 述 例子 ,运行 效果 如 图 6-12 所 示 。 


国 sibset we wnle 


€ 0 O127.0.0.1: tes/06/subsetTag. jsp 安国 
利用 subset 从 列表 中 截取 子 集 ， 起 始 索引 为 2， 截 取 3 个 元 素 


345 


利用 var 属 性 将 截取 的 子 集 保存 到 pageContext 中 
123 
自 定义 Decider， 获 取 列表 中 的 奇数 


135 


6-12 ”subset 标签 的 运行 效果 
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646 sort 标签 


sort 标签 利用 设置 的 比较 器 来 对 指定 的 集合 进行 排序 。sort 标签 的 属性 如 表 6-16 所 示 。 
表 6-16 sort 标签 的 属性 


属性 名 是 否 必需 类 型 说 明 
Collection、Map、 Enumeration、| 指定 要 排序 的 集合 。 缺 省 时 , 取 Value 
人 否 Iterator 或 Array Stack 的 栈 顶 元 素 作为 源 集合 
comparator 是 java. util. Comparator 指定 排序 时 使 用 的 比较 器 


用 于 引用 排序 后 的 集合 对 象 。 指 定 该 属 


var 否 String 性 后 ,排序 后 的 集合 将 放 入 Page Context 


要 想 使 用 sort 标签 对 集合 元 素 进行 排序 ,首先 应 该 自 定义 一 个 比较 各 个 元 素 的 比较 
器 。 代 码 6-16 给 出 了 一 个 比较 器 的 例子 。 


代码 6-16 ”编写 比较 器 


jimport java.util .Canparator; 
Public class MyComparator implements Comparator< String> { 
Public int ompare (String ol, String c2) { 
int diff=01.length()- o2.length(); 
if(diff==0) 
diff= 01.toLowerCase () .compareTo (02.toLowerCase ()); 
retum diff; 


3 


比较 器 MyComparator. java 实现 了 java. util. Comparator 接口 。 该 比较 器 用 于 比较 
两 个 字符 串 的 长 度 。 长 度 相 等 的 字符 串 ,按照 字母 表 比 较 。 代 码 6-17 演示 了 sort 标签 
如 何 利用 MyComparator 对 列表 进行 排序 。 
代码 6-17 sort 标签 的 用 法 


<h3> 利 用 subset 从 列表 中 截取 子 集 ,起 始 索引 为 2, 截 取 3 个 元 素 < /h3> 
< 3:sort souroe= "# myList" comparator= "nyComparator'"> 
< s:iterator> 
< s:property /> 
< /s:iterator> 
</s:sort> 


<h3> 利 用 var 属 性 将 截取 的 子 集 保存 到 Pagecontext 中 < /h3> 
< 3:sort souroe= "# myList" comparator= "myComparator" var= "sortedList"/> 


< 
Iterator i= (Iterator) pageContext .getAttribute ("sortedList"); 
while(i.hasNext ()) { 
ut .print (i.next ()+ "gnbep;"); 
3 
S> 
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在 浏览 器 中 查看 上 述 例子 ,运行 效果 如 图 6-13 所 示 。 


国 sort te ernle 


€ >C| 127.0.0.1:8080/notes/06/sortTag. jsp 家 


对 列表 中 的 字符 串 按照 长 度 由 小 到 大 排序 ， 长 度 相等 的 按照 字母 表 排序 


red blue grey pink black yellow 
利用 var 属 性 将 排序 结果 保存 到 pageContext 中 


red blue grey pink black yellow 


图 6-13 sort 标签 的 运行 效果 


65 表单 标签 

表单 标签 用 于 生成 HTML 元 素 的 标签 。 表 单 标签 由 form 标签 和 包装 HTML 表单 
元 素 的 其 他 标签 。 

651 表单 标签 的 公共 属性 


Struts 2 中 的 表单 标签 对 应 的 类 都 继承 自 UIBean 类 ,UIBean 基 类 提供 了 一 组 公共 
的 属性 。 表 6-17 给 出 了 这 些 标签 的 通用 属性 ,其 中 加 “x* ”的 属性 仅 在 没有 使 用 simple 
主题 时 方 可 使 用 。 与 主题 有 关 的 内 容 将 在 6.6 节 讲 述 。 


表 6-17 表单 标签 的 通用 属性 


名 学 类 型 说 明 
cssClass String 设置 HTML 表单 元 素 的 class 属性 
cssStyle String 设置 HTML 表单 元 素 的 style 属性 
title String 设置 HTML 表单 元 素 的 title 属性 
id String 设置 HTML 表单 元 素 的 id 属性 
disabled String 设置 HTML 表单 元 素 的 disabled 属性 
label* String 设置 与 HTML 表单 元 素 关联 的 label 


labelpostion™ 


String 设置 HTML 表单 元 素 的 label 的 位 置 (left|top) 。 默 认为 left 


required” 


设置 HTML 表单 元 素 是 否 为 必 填 项 。 为 true 时 ,在 label 上 加 “x ”。 


Boolean | 默认 值 false 


requiredpostion String 设置 必 填 标记 相对 于 label 的 位 置 (left|top) 。 默 认 值 为 right 


tabindex String 设置 HTML 表单 元 素 的 tabindex 属性 

name String 设置 HTML 表单 元 素 的 name 属性 。 该 值 对 应 Action 类 的 属性 
value String 设置 HTML 表单 元 素 的 value 属性 

key String ”| 设置 HTML 表单 元 素 的 name、label 和 value, 其 值 来 自 国际 化 文件 


通用 属性 中 的 name 属性 最 为 重要 ,该 属性 和 处 理 表单 的 Action 类 中 的 属性 相对 
应 。 在 没有 为 标签 设置 value 属性 时 ,表单 元 素 自动 从 Action Stack 中 查找 名 为 name 的 
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对 象 (通常 为 Action 的 属性 ) ,利用 该 对 象 的 值 作为 该 标签 的 value 值 。 
表单 还 包含 了 与 触发 JavaScript 事件 相关 的 属性 ,例如 onclick 和 ondblclick 等 ,这 
些 属性 与 HTML 标签 的 标准 JavaScript 属性 完全 一 致 ,在 此 不 青 蒙 述 。 
除了 通用 属性 外 ,还 有 些 属性 与 模板 和 浮动 提示 有 关 , 如 表 6-18 所 示 。 


表 6-18 表单 标签 的 其 他 属性 


名 闻 类 型 说 明 
templateDir String 设置 模板 目录 
theme String 设置 主题 (simple|xhtml|css_xhtml|ajax)。 默 认 值 为 xhtml 
template String 设置 模板 名 称 
tooltip String 设置 表单 元 素 的 工具 提示 
tooltipConfig String 设置 与 工具 提示 相关 的 属性 
652 fom 标 签 


form 标签 用 于 生成 HTML 中 的 form 表单 。 除 公共 属性 外 ,form 标签 的 常用 属性 
如 表 6-19 所 示 。 


表 6-19 ”form 标签 的 常用 属性 


击 - 府 类 型 说 明 
action String 设置 提交 的 Action 的 名 字 
namespace String 设置 Action 的 命名 空间 
method String 设置 HTML 表单 的 form 属性 (get| post) 。 默 认 值 为 post 
enctype String 在 上 传 文件 时 ,需要 将 该 属性 设置 为 multipart/form-data 
validate String 在 xhtml/ajax 主题 下 是 否 执行 客户 端 验证 。 默 认 值 为 false 
id String 设置 HTML 表单 的 id 属性 


在 web. xml 将 核心 控制 器 的 url-pattern 属性 设置 为 “"/ x ”时 ,可 以 省 略 action 属性 
的 扩展 名 (. action) ,否则 不 能 省 略 。 
例如 ,语句 


< 3:fom action= "/notes/login.action"> ... < /s:fornm> 


将 调用 /notes 命名 空间 中 名 为 的 login 的 action。 
在 浏览 器 中 查看 上 述 语句 生成 的 HTML 源码 如 下 : 
< fom id "framl" name= "framl" action= "login.action" method "post"> 
< table class= "womdTable"> 
< /table> 
< /fom> 
从 中 可 以 看 到 : 
(1) 生成 的 代码 除了 一 个 form 表单 之 外 ,还 有 一 个 table 表格 。 因 此 ,默认 情况 下 
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form 表单 自动 采用 表格 进行 布局 。 

(2) 在 默认 表单 的 id 和 name 属性 的 值 时 ,Struts 2 将 id 和 name 的 值 设 置 为 action 
的 名 字 。 实 际 上 ,在 表单 的 action 属性 的 缺 省 时 ,表单 的 action 属性 将 自动 设置 为 当前 
JSP 页 面 或 请 求 Action 的 名 字 。 另 外 ,在 表单 中 的 某 个 标签 的 id 值 没有 指定 时 ,Struts 2 
将 其 设置 为 “表单 id_ 表 单 标签 的 name”。 

653 texfidd、password 和 hidden 标 签 

textfield 标签 用 于 输出 一 个 HTML 单行 文本 框 , 对 应 HTML 的 二 input type 一 "text" 二 。 

password 标签 用 于 输出 一 个 HTML 口令 输入 控件 ,对 应 HTML 的 <input type 一 
"password" > 。 

hidden 标签 用 于 输出 一 个 HTML 隐藏 表单 元 素 , 对 应 HTML 的 二 input type 一 
"hidden" 之 。 除 公共 属性 外 ,hidden 标签 没有 其 他 属性 。 

除了 公共 属性 外 ,textfield 和 password 标签 还 具有 表 6-20 所 示 的 公共 属性 。 

表 6-20 textfield 和 password 标签 的 公共 属性 


名 字 类 型 说 明 
maxlength String 输入 框 所 能 容纳 的 最 大 文本 长 度 
readonly Boolean 设置 元 素 是 否 是 只 读 。 默 认 值 为 false 
Size String 设置 显示 的 尺寸 


除了 上 述 属性 外 ,password 标签 还 有 一 个 showPassword 属性 。 当 该 属性 的 值 被 设 
置 成 true 时 ,password 标签 将 显示 密码 。 
下 面 的 语句 演示 了 textfield 和 password 标签 的 用 法 。 
< :form acticn= "/notes/login.action" idF "forml"> 
< s:textfield name= "username" size= "40" label=" 用 户 名 "> < /s:textfield> 
< s:password name= "password" size= "40" label= "密码 "> < /s:password> 
< s:hidden name= "id" value= "10"> < /s:hidden> 
< /s:fom> 


654 tedarea 标 签 


textarea 标签 用 于 输出 一 个 HTML 多 行文 本 框 ,对 应 HTML 的 二 textarea... 之 。 除 
了 公共 属性 外 ,textarea 标签 还 具有 表 6-21 所 示 的 属性 。 
表 6-21 textarea 标签 的 属性 


名 字 类 型 说 明 

cols Integer 设置 多 行文 本 框 的 列 数 

rows Integer 设置 多 行文 本 框 的 行 数 

readonly Boolean 设置 多 行文 本 框 是 否 是 只 读 。 默 认 值 为 false 
size String 设置 多 行文 本 框 中 的 内 容 是 否 自动 换行 
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例如 : 


< 3:textarea name= "content" cols- "80" rows= "20"> < /s:textarea> 


655 resst 标签 
reset 标签 用 于 输出 一 个 重 置 按钮 。 除 了 公共 属性 外 ,reset 标签 还 具有 表 6-22 所 示 
的 属性 。 
表 6-22 reset 标签 的 属性 
名 字 类 型 说 明 
type String 用 于 设置 重 置 按钮 的 类 型 (input|button) 。 默 认 值 为 input 


当 type 取 值 为 input 时 ,等 价 于 HTML 的 二 input type 一 "reset".../ 二 。 此 时 需要 
通过 value 属性 设置 重 置 按 钮 的 文本 。 

当 type 取 值 为 button 时 ,等 价 于 HTML 的 二 button type= "reset" .../ 二 。 此 时 需 
要 通过 label 属性 设置 重 置 按钮 的 文本 。 

例如 : 


< s:reset value=" 重 填 ">< /s:reset> 
< 3:reset type= "button" value= " 量 填 >< /s:reset> 


656 subnit 标签 
submit 标签 用 于 输出 一 个 提交 按钮 。 除 了 公共 属性 外 ,submit 标签 还 具有 表 6-23 
所 示 的 属性 。 
表 6-23 submit 标签 的 属性 

者 字 类 型 说 明 
action String 设置 HTML 的 action 属性 
method String 设置 使 用 Action 的 哪个 方法 处 理 请 求 
type String 设置 提交 按钮 的 类 型 (input|button|image) 。 默 认 值 为 input 
Src String 当 type 二 "image" 时 ,为 提交 按钮 设置 图 片 地 址 


当 type 取 值 为 input 时 ,等 价 于 HTML 的 二 input type 二 "submit" .../ 二 。 此 时 需 
要 通过 value 属性 设置 提交 按钮 的 文本 。 

当 type 取 值 为 button 时 ,等 价 于 HTML 的 二 button type 二 "submit" .../ 二。 此 时 
需要 通过 label 属性 设置 提交 按钮 的 文本 。 

当 type 取 值 为 image 时 ,等 价 于 HTML 的 二 button type 一 "image".../ 二 。 

Struts 2 为 submit 标签 的 name 属性 定义 了 4 个 前 缀 。 

(1) method 前 级 : 用 于 指定 调用 Action 的 哪个 方法 。 

(2) action 前 缀 : 可 以 改变 表单 的 提交 行为 。 

(3) redirect 前 缀 : 用 于 将 请 求 重 定向 到 URL。 
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(4) redirectAction 前 级 : 用 于 将 请 求 重 定向 到 其 他 Action 。 
代码 6-18 给 出 了 一 个 例子 。 在 这 个 例子 中 ,表单 通过 不 同 的 submit 按钮 处 理 不 同 
的 用 户 请 求 。 请 注意 代码 中 的 注释 部 分 。 


代码 6-18 一 个 表单 中 有 多 个 submit 按钮 


< s:form action= "login.action" id "framl"> 
< s:textfield name~ "usernamen size= "40" label= "用 户 名 "> < /s:textfield> 
< s:password name= "password" size= "40" label= 嘲 码 "> < /s:password> 


< !-- 使 用 fom 的 action 属 性 处 理 请 求 --> 
<s:submit value= "登录 吃 </s:submit> 


< 上 -使 用 register.action 取 代 fom 标 签 指定 的 acticn --> 
<3:submit value= "注册 " name= "action:register"/> 


< !-- 使 用 login.acticn 的 forgetPassword 方 法 处 理 请 求 
等 价 于 < s:submit value=' 密 记 密 码 2" method= "forgetPassword"/> 
——> 
<s:3ubmit value= " 密 记 密码 " name= "method:forgetPassword"/> 


< !-- 使 用 redirect 前 缀 将 请 求 重 定 向 到 google 一 > 
< s:submit value= "搜索 " name= "redirect:http://www.google.cam.hk"/> 
< s:reset type= "input" value= 哑 填 "/> 

</s:form> 


657 checkbox 标签 


checkbox 标签 用 于 输出 一 个 HTML 复 选 框 , 对 应 HTML 的 二 input type 一 
"checkbox" 二 标签 。checkbox 标签 只 能 表达 Boolean 值 , 因 此 用 于 处 理 请 求 的 Action 类 
中 的 对 应 属性 的 类 型 必须 是 Boolean 类 型 。 

除了 公共 属性 外 ,checkbox 标签 还 具有 表 6-24 所 示 的 属性 。 


表 6-24 checkbox 标签 的 属性 


名 字 类 型 说 明 
fieldValue ”| ”String ”| 指定 在 复 选 框 选中 时 ,实际 提交 的 值 (true| false) 。 默 认 值 为 true 


在 fieldValue 的 值 为 true 时 ,例如 : 
< s:checkbox name- "remenber" label= " 记 住 密码 " > < /s:checkbox> 


如 果 用 户 在 表单 上 选中 了 该 按钮 , 则 Action 类 的 remember 属性 将 被 设置 为 true， 
否则 remember 的 值 将 为 false。 
在 fieldValue 的 值 为 false 时 ,例如 : 


< 3:checkbox name= "remenber" fieldValue= "false" label= " 记 住 密码 " /> 
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无 论 用 户 是 否 在 表单 上 选中 remember 按钮 ,Action 类 的 remember 属性 都 会 被 设 
置 为 false。 因 此 ,除非 用 户 知道 自己 正在 做 什么 ,否则 不 要 将 fieldValue 设置 为 false。 


658 ” checkboxist 和 rado 标 签 


checkboxlist 标签 用 于 输出 一 组 HTML 复 选 框 .等 价 于 一 组 二 input type 一 
"checkbox" ...>。 

radio 标签 用 于 输出 一 组 HTML 单 选 按钮 ,等 价 于 一 组 二 type 二 "radio" ... 记 。 

除了 公共 属性 外 ,checkboxlist 和 radio 标签 还 具有 表 6-25 所 示 的 属性 。 


表 6-25 checkboxlist 和 radio 标签 的 属性 


名 字 类 型 说 明 


用 于 生成 多 选 框 或 单 选 按钮 的 集合 (Collection、Map、Enumeration、 Iterator 
或 Array) , 必 填 


listKey String | 用 集合 对 象 的 哪个 属性 生成 checkbox 或 radio 的 value 属性 
listValue String “| 用 集合 对 象 的 哪个 属性 生成 checkbox 或 radio 选项 的 内 容 


list String 


在 下 面 的 例子 中 ,演示 了 生成 多 选 框 和 单 选 按钮 的 不 同方 法 。 代 码 6-19 给 出 的 
RadioChecklistAction. java 类 是 这 个 例子 的 Action 类 。 在 这 个 类 中 定义 了 一 个 静态 的 
favorites 列表 。 这 样 ,不 管 该 Action 类 有 多 少 个 实例 ,这 个 列表 只 需 填充 一 次 即 可 。 请 
注意 掌握 这 种 方法 。 


代码 6-19 ”RadioChecklistAction. java 类 


/* Favorite.java * / 
Public class Favorite { 
int favId; 
String favName; 
/* 省 略 了 getter 和 setter 方 法 的 代码 ,请 读者 自行 添加 * / 
¥ 


/* Favorite.java */ 
piblic class RadiochecklistAction extends ActionSupport { 
Private static List< Favorite> favorites; 
static{ 
favorites= new ArrayList< Favorite> (); 
String[] 一 { 中 山 ", "游泳 ", "慢跑 " 跳舞 ", 喇 步 " }; 
for (int i=0; i <s.length; i++) { 
Favorite f= new Favorite(); 
.setEavId(i) 7 
£.3etFavName (s[i]); 
favorites.add (f); 


} 


piblic List< Favorite> getFavorites() { 
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retum favorites; 
} 


public String execute() throws Excepticn { 
Ietum SUOCESS; 
} 
3 


代码 6-20 中 定义 了 两 组 checkboxlist 和 一 组 radio。 
代码 6-20 ”checkboxlist 和 radio 标签 的 用 法 


<s:fom> 
<!-- 用 Mp 填充 radio --> 
<s:radio list=- 啡 {11:" 男 2:" 女 ")" label- "性 别 " name= "gender" 
value= "1"> < /s:radio> 


< 上 -用 action 类 的 集合 属性 填充 checkboxlist --> 
< s:checkboxlist name= "fav" list= "favorites" listKey= "favId" 
listValue= "favName" label= "兴趣 爱好 "> < /s:checkboxlist> 


<!-- 用 List 填 充 deckboxdist --> 


< s:radio name= "education" list="{' 耸 中 ',' 本 科 ',' 跨 士 ',' 博 士 ',' 其 他 '}" 


label= 喇 育 程度 ">< /s:radio> 
</s:form> 


659 select 标签 


select 标签 用 于 输出 一 个 HTML 列表 框 , 等 同 于 HTML 代码 二 select ... 


<option ...> ... </option> </select>。 
除了 公共 属性 外 ,select 标签 还 具有 表 6-26 所 示 的 属性 。 


表 6-26 select 标签 的 属性 


类 .学 类 型 说 明 
用 于 生成 列表 框 的 集合 对 象 (Collection、Map、Enumeration, Iterator 
list String 
或 Array) , 必 填 
listKey String 用 集合 对 象 的 哪个 属性 生成 列表 框 的 value 属性 
listValue String 用 集合 对 象 的 哪个 属性 生成 列表 框 的 内 容 


headerKey String 在 所 有 的 选项 前 加 额外 的 一 个 选项 作为 其 标题 的 value 属性 


headerValue String 在 所 有 的 选项 前 加 额外 的 一 个 选项 作为 其 标题 的 显示 文字 


emptyOption Boolean 在 标题 后 是 否 添加 一 个 空 行 。 默认 值 为 false 


multiple Boolean 是 否 表 现 为 多 选 列表 。 默 认 值 为 false 


size Integer 列表 框 中 可 显示 的 选项 个 数 。 当 size>1 时 ,表现 为 列表 框 


在 代码 6-21 给 出 的 例子 中 ,演示 了 生成 列表 框 的 不 同方 法 。 
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代码 6-21 select 标签 的 用 法 


<!-- 用 匡 st 对象 生 成 下 拉 框 一 > 
<s:select list= "{f" 软 件 工程 "计算 机 科学 与 技术 ,数字 媒体 "通行 工程 ']" 
name= "department" label= "选择 专业 " >< /s:select> 
<!-- 用 Mp 对 象 生成 下 拉 框 ,默认 显示 为 呈 据 结构 " --> 
<s:select list= 啡 {1':aava 语 言 ,"2': 数 据 结构 "3':" 数 据 库 '， 
"4':' 网 络 工程 '}" name= "course" label= "选择 课程 " value= "2"> < /s:sslect> 


< !-- 使 用 集合 里 放 多 个 JavaBean 实例 来 生成 下 拉 框 --> 
< s:select list= "i 3.acheols" listkey= "id" listValue= "neme" nare= "sdhool" 
label= "选择 学 院 " labelposition= "top" >< /s:select> 


<! 一 多 选 框 一 > 

<s:select list="{' 了 仆 山 ',' 游 泳 ',' 慢 跑 '，' 跳 舞 '，' 散 步 '}" name= "favorite" 
sizer mm" label= "选择 你 最 喜欢 的 运动 " headervaluer ' 选 择 你 最 喜欢 的 运动 ' 
headerkey- '- 1' emptyopticnr "true" mltiple= "true"> < /s:select> 


图 6-14 给 出 了 select 标签 在 浏览 器 中 的 输出 效果 。 


Select tag exanple 


€ 3C ©127.0.0.1:8080/notes/06/selectTag. jsp 家 | 


[ 获 件 工程 国 
[ 改 据 结构 国 


夸 择 你 最 喜欢 的 运动 全 | 


用 山 
选择 你 最 喜欢 的 运动 : 洲 汪 
| 慢 跟 


跳舞 
肯 步 


图 6-14 select 标签 在 浏览 器 中 的 输出 效果 


上 述 例子 中 用 到 一 个 SchoolService JavaBean 类 为 下 拉 框 填充 数据 。 代 码 6-22 给 出 
有 关 SchoolService 的 实现 细节 。 


代码 6-22 ”填充 Select 标签 的 JavaBean 类 


/* School.java * / 

public class School { 
private String id; 
Private String name; 


Public School (){} 
Public School (String id, String name){ 
this.icF id; 


this.name= name; 
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/* 省略 了 get 和 set 方 法 */ 
i 


/* SchoolService.java * / 
public class SchoolService { 
Eublic School [] getSchools(){ 
retum new School[]{ 

new School ("001", "计算 机 学 院 "， 
new School ("002" "理学 院 "， 
new School ("003", " 信 控 学 院 ”， 
new School ("004"," 石 化 学 院 ") 


6510 qplgoup 标 签 
optgroup 标签 通常 作为 select 标签 的 子 标签 使 用 ,用 来 生成 选项 组 。optgroup 标签 
也 具有 list \listKey 和 listValue 属性 ,它们 的 含义 和 用 法 与 select 标签 中 同名 属性 的 含 


义 和 用 法 完全 一 样 。 
在 使 用 optgroup 标签 时 ,可 以 使 用 label 属性 为 每 个 选项 组 指定 一 个 组 名 。 但 是 需 


要 注意 ,这 个 组 名 用 户 是 无 法 通过 鼠标 选择 的 。 
代码 6-23 所 示 是 Struts 2 文档 中 一 个 关于 optgroup 标签 的 例子 。 


代码 6-23 ”optgroup 标签 的 用 法 


<s:fom> 
< 3:select label= "My Selection" name= "mySelection" 
list= 啡 {'SUPERMAN' : 'Superman', 'SPITEFMAN': 'spiderman' }"> 
< 3:optgroup label= "Poult" list= "# {"SOUTH ERRK': 'South Park'}" /> 
< s:optgroup label= "Japanese" list= "# {'EOKEMCON': ‘pokemon', 
'DIGIMON" : 'digimon', "SAILORMDON"' : 'Sailormmoon'}" /> 
</s:select> 
< /s:fom> 


图 6-15 给 出 了 上 述 代 码 在 浏览 器 中 的 输出 效果 (图 中 显示 的 是 单 击 后 展开 的 效果 )。 


国 pteow te exwmple 、 
€ 3 127.0.0.1:8080/notes/06/. iN 


Ny Selection: 


图 6-15 optgroup 标签 在 浏览 器 中 的 输出 效果 
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6511 conbobox 标 签 


combobox 标签 用 于 生成 一 个 文本 框 和 一 个 下 拉 框 。 当 下 拉 框 中 的 选项 改变 时 , 它 
的 值 将 赋 给 文本 框 。 由 于 最 终 提交 的 是 文本 框 中 的 值 ,因此 可 以 使 用 选项 外 的 其 他 内 容 
作为 提交 的 数据 。 

除了 公共 属性 外 , combobox 标签 也 具有 list、 listKey、 listValue、 headerKey、 
headerValue 和 emptyOption 属性 ,它们 的 含义 和 用 法 与 select 标签 中 同名 属性 的 含义 
和 用 法 完全 一 样 。 除 此 之 外 ,combobox 标签 还 具有 表 6-27 所 示 的 属性 。 


表 6-27 ”combobox 标签 的 属性 


名 字 类 型 说 明 
maxlength Integer 文本 框 中 能 够 输入 的 文本 的 最 大 长 度 
readonly Boolean 设置 文本 框 是 否 为 只 读 , 默 认 值 为 false 
size Integer 列表 框 中 可 显示 的 选项 个 数 , 当 size>1 时 ,表现 为 列表 框 


下 面 的 代码 给 出 了 combobox 标签 的 用 法 。 


<s:cabcbox list= "{f" 卜 山 "，' 游 泳 "，' 慢 跑 '，' 跳 舞 ， 散步 四 " 
name= "favoriate” label= "选择 你 最 喜欢 的 运动 " size= "20" 
headerkey= '- 1' headerValue= ' 选 择 你 最 喜欢 的 运动 ' erptyoption= "true"> 
< /s:ccrbcbox> 


65 人 2 updowsaect 标 签 


updownselect 用 于 输出 一 个 带 有 上 、 下 移动 按钮 的 列表 框 。updownselect 标签 的 实 
现 类 是 从 select 标签 的 实现 类 上 扩展 而 来 的 ,因此 它 具 有 select 标签 的 所 有 属性 ,如 list、 
listKey 等 。 除 了 这 些 属性 和 公共 属性 外 ,updownselect 标签 还 具有 表 6-28 所 示 的 属性 。 


表 6-28 updownselect 标签 的 属性 


名 这 类 型 说 明 
moveUpLabel String 设置 上 移 按 钮 显示 的 文本 
moveDownLable String 设置 下 移 按钮 显示 的 文本 
selectAllLabel String 设置 全 选 按钮 显示 的 文本 
allowMoveUp Boolean 是 否 显示 向 上 移动 按钮 。 默 认为 true 
allowMoveDown Boolean 是 否 显示 向 下 移动 按钮 。 默 认为 true 
allowSelectAll Boolean 是 否 显 示 全 部 移动 按钮 。 默 认为 true 


代码 6-24 演示 了 updownselect 标签 的 用 法 。 
代码 6-24 updownselect 标签 的 用 法 


< s:head/> 
<s:fom id "framl"> 
< 上 -简单 的 updownselect --> 
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<s:updownselect list="# {'england': "England', ‘america': ‘America', 
'gemeny': 'Gemreny'}" namer "prioritisedFavouriteCountries™" 
heagerkey-= "- 1" headerValue- "-- -请 排序 --- "emptyOption= "true" /> 


<! 一 定制 的 updownselect 一 > 
<s:updownselect list= "{f" 卜 山 "，' 游 泳 "，' 慢 跑 '，' 跳 舞 … 散步 四 " 
mame= "favorite" headerKey= "- 1" headervalue=" - -请 排序 ---" 
enptyOption= "true" allowMpve0p= "true" allonMpveDownr "true" 
allowSelectAll= "true" moveUpLabel= "上 移 " moveDownLabel=" 下 移 " 
selectAllTabel= "全 选 " size= "8" /> 
</s:fom> 


使 用 updownselect 标签 时 ,必须 配合 使 用 Struts 2 的 head 标签 ,因为 updownselect 
标签 需要 引用 Struts 2 的 utils. js,head 标签 会 自动 识别 并 引入 它 。 
图 6-16 给 出 了 上 述 代码 在 浏览 器 中 的 输出 效果 。 


国 waommsaect tec meplx 


4 COl127.0o.0. stes/06/updownselectTe RN 


一 Please Order Them Accordingly — 到 | 


England 


图 6-16 updownselect 标签 在 浏览 器 中 的 输出 效果 


6513 doubleselect 标签 


doubleselect 标签 用 于 输出 两 个 联动 的 HTML 列表 框 。 当 选择 第 一 个 列表 框 的 内 
容 时 ,第 二 个 列表 框 的 选项 随 着 变化 ,更 新 成 和 第 一 个 列表 框 选项 相关 的 一 组 选项 。 
除了 公共 属性 外 ,doubleselect 标签 还 具有 表 6-29 所 示 的 属性 。 


表 6-29 ”doubleselect 标签 的 属性 


名 字 类 型 说 明 
list Si 用 于 生成 第 一 个 列表 框 的 集合 对 象 (Collection、Map、 Enumeration、 
Iterator 或 Array) , 必 填 
listKey String 用 集合 对 象 的 哪个 属性 生成 第 一 个 列表 框 的 value 属性 
listValue String 用 集合 对 象 的 哪个 属性 生成 第 一 个 列表 框 的 内 容 
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续 表 
名 学 类 型 说 明 
Ps Silig a value 
headerValue pi 3 
emptyOption Boolean | 在 第 一 个 列表 框 的 标题 后 是 否 添加 一 个 空 行 。 默 认 值 为 false 
size Integer | 第 一 个 列表 框 中 可 显示 的 选项 个 数 
multiple Boolean | 是 否 表现 为 多 选 列表 。 默 认 值 为 false, 对 两 个 列表 框 均 有 效 
doubleList Sie 用 于 生成 第 二 个 列表 框 的 集合 对 象 (Collection、Map、 Enumeration、 
Iterator 或 Array) , 必 填 
doubleListKey String “| 用 集合 对 象 的 哪个 属性 生成 第 二 个 列表 框 的 value 属性 
dobuleListValue | String 用 集合 对 象 的 哪个 属性 生成 第 二 个 列表 框 的 内 容 
doubleSize Integer | 第 二 个 列表 框 中 可 显示 的 选项 个 数 
doubleName String 第 二 个 下 拉 框 的 name 属性 , 必 填 
doubleValue String 第 二 个 下 拉 框 的 初始 选中 项 


代码 6-25 演示 了 doubleselect 标签 的 第 一 种 用 法 。 


代码 6-25 ”doubleselect 标签 的 第 一 种 用 法 


<s:head> 


<s:fom> 


< ssdoubleselect label= "请 选择 学 院 " 
name= "school" 
doubleName= "department" 
doubleValue="' 软 件 工程 系 '" 
list="{' 计 算 机 与 通信 工程 学 院 ', "信息 与 控制 工程 学 院 , ' 理 学 院 ")" 
doubleList="(top==' 计 算 机 与 通信 工程 学 院 ') ? 
{' 计 算 机 系 ', "软件 工 程 系 '}: 


/> 


(tor 


)" 


</s:fom> 


< /s:head> 


= ' 信 息 与 控制 工程 学 院 '? 
{' 自 动 化 系 ',' 测 控 与 仪表 系 '}: 
{" 应 用 数学 , "信息 与 计算 科学 '} 


在 上 面 的 代码 中 ,doubleselect 标签 的 list 属性 直接 指定 了 一 个 List 集合 ,里 面 有 三 
个 元 素 ; 而 doubleList 属性 的 值 是 一 个 三 目 运算 符 , 其 中 的 top 关键 字 代表 第 一 个 下 拉 框 
当前 被 选中 的 选项 值 ,如 果 是 “计算 机 与 通信 工程 学 院 ” 被 选中 , 则 把 “计算 机 系 * 和 “软件 
工程 系 ”两 项 添加 到 下 边 的 下 拉 框 中 ;如 果 是 “信息 与 控制 工程 学 院 ” 被 选中 ,把 “自动 化 
系 ” 和 “测控 与 仪表 系 ”两 项 添加 到 下 边 的 下 拉 框 中 ;否则 ,把 “应 用 数学 ”和 “信息 与 计算 
科学 ”两 项 添加 到 第 二 个 下 拉 框 中 。 

代码 6-26 演示 了 doubleselect 标签 的 第 二 种 用 法 。 
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代码 6-26 ”doubleselect 标签 的 第 二 种 用 法 


<s:head/> 
< s:fomm> 
< s:set name= "sd" 
value= 啡 {" 计 算 机 与 通信 工程 学 院 ': {' 计 算 机 系 ', "软件 工 程 系 ',' 通 信 工 程 系 '}， 
"信息 与 控制 工程 学 院 ': {" 自 动 化 系 ', "测控 与 仪表 系 ',' 电 子 信 息 工 程 系 '}， 
"理学 院 ': {' 应 用 数学 ', "信息 与 计算 科学 ']}" /> 


<s:doubleselect label= "请 选择 学 院 " size= "3" 
name= "school 1ist= 啡 sd.keyset ()" 
doubleList= 啡 sd[top]" doublesize= "3" 
doubleName= "department 2"/> 


< /s:fom> 


注意 上 述 代码 中 list 属性 和 doubleList 属性 的 赋值 。 
图 6-17 给 出 了 上 述 代码 在 浏览 器 中 的 输出 效果 。 


doubleselect tag exanpl, x 


| 测 容 与 仪表 系 
(eT 


图 6-17 doubleselect 标签 在 浏览 器 中 的 输出 效果 


6514 optiontransfersaect 标 答 


optiontransferselect 标签 用 来 生成 两 个 左右 放置 的 列表 框 , 通 过 按钮 可 以 控制 选项 
在 两 个 列表 框 之 间 移 动 。 

optiontransferselect 标签 的 实现 类 是 从 doubleselect 标签 的 实现 类 上 扩展 而 来 的 ， 
因此 , 它 具 备 表 6-29 中 列 出 的 所 有 与 doubleselect 标签 有 关 的 属性 (multiple 属性 除外 ) 。 
除了 这 些 属性 和 公共 属性 外 ,optiontransferselect 标签 还 具有 表 6-30 列 出 的 属性 。 


表 6-30 ”optiontransferselect 标签 的 属性 


名 字 类 型 说 明 
multiple Boolean 左边 的 列表 框 是 否 允 许多 选 。 默 认 值 为 false 
doubleMultiple Boolean 右边 的 列表 框 是 否 允许 多 选 。 默 认 值 为 false 
leftTitle String 左边 列表 框 的 标题 
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续 表 

名 字 类 型 说 明 
rightTitle String 右边 列表 框 的 标题 
addToLeftLabel String 向 左 移动 按钮 上 显示 的 文本 
addTRightLabel String 向 右 移动 按钮 上 显示 的 文本 
addToAllLeftLabel String 全 部 移动 到 左边 按钮 上 显示 的 文本 
addToAllRightLabel String 全 部 移动 到 右边 按钮 上 显示 的 文本 
selectAllLabel String 选择 全 部 按钮 上 显示 的 文本 
leftUpLabel String 左边 下 拉 框 上 移 按钮 上 显示 的 文本 
leftDownLabel String 左边 下 拉 框 下 移 按钮 上 显示 的 文本 
rightUpLabel String 右边 下 拉 框 上 移 按钮 上 显示 的 文本 
rightDownLabel String 右边 下 拉 框 下 移 按 钮 上 显示 的 文本 
allowAddToleft Boolean 是 否 出 现 向 左 移动 按钮 。 默 认 值 为 true 
allowAddToRight Boolean 是 否 出 现 向 右 移动 按钮 。 默 认 值 为 true 
allowSelectAll Boolean 是 否 出 现 选择 全 部 按钮 。 默 认 值 为 true 
allowUpDownOnLeft Boolean 是 否 出 现 左 边 列表 框 的 上 下 移动 按钮 。 默 认 值 为 true 
allowUpDownOnRight Boolean 否 出 现 右边 列表 框 的 上 下 移动 按钮 。 默 认 值 为 true 


代码 6-27 演示 了 optiontransferselect 标签 的 用 法 。 
代码 6-27 ”optiontransferselect 标签 的 用 法 


<s:head/> 


<s:fom> 


< 3:coptiontransferselect 


label= 哺 选择 课程 " 
name= "allCourse" 
leftTitle- 哈 部 课程 :" 


rightTitle= 吧 选择 课程 " 


list= "{' 网 络 工程 " 议 骆 数学 " 唱 作 系统 ']" 


headerKey= "courseKey" 


headervalue= "-- -全 部 课程 一 -" 


emptyOption= "true" 


doubleList="{"'Java 程 序 设计 '， 呈 据 结构 ',' 面 向 对 象 程 序 设计 '}" 


doubleName= "enBook" 
doubleHeaderKey- "enKey" 


doubleHeaderValue= "-- -选择 课程 一 一 " 
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doublegmptyOption= "true" 
doubleMnltipler= "truen 
人 > 


< /s:fom> 


图 6-18 给 出 了 上 述 代码 在 浏览 器 中 的 输出 效果 。 


国 optiontransferselect ta x 
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谤 送 帮 误 全 部 课程 ， 
和 


图 6-18 optiontransferselect 标签 在 浏览 器 中 的 输出 效果 


6515 其 他 U 标 签 


除了 上 面 介绍 的 标签 之 外 ,还 有 一 些 比较 简单 的 标签 ,也 具有 上 述 通 用 属性 。 
(1) file 标 签 : 输出 一 个 HTML 文件 选择 框 ,等 价 于 二 input type= "file" 之 。 将 在 


后 面 的 文件 上 传 部 分 讲述 该 标签 。 


(2) label 标签 : 输出 一 个 文本 值 , 也 可 以 为 其 他 标签 提供 label 值 。 
(3) head 标签 : 该 标签 不 产生 任何 表单 项 ,但 是 某 些 标签 可 能 需要 引用 JavaScript。 


head 标签 能 够 自动 识别 页 面 需要 Struts 2 的 哪些 js 文件 ,并 自动 导入 。 


(4) token 标签 : 用 于 输出 两 个 隐藏 的 表单 字段 ,用 于 防止 表单 的 重复 提交 。 使 用 


时 ,需要 启用 TokenInterceptor 或 者 TokenSessionInterceptor 拦截 器 。 


66 actionerror ,acionmessage 和 fidderrar 标签 


actionerror、actionmessage 和 fielderror 标签 都 是 用 于 输出 消息 的 ,不 同 的 是 


actionerror 标签 输出 的 是 Action 的 错误 信息 ,actionmessage 标签 输出 的 是 Action 的 一 
般 性 消息 ,而 fielderror 标签 输出 的 是 和 action 属性 有 关 的 错误 。 程 序 员 可 以 在 Action 
类 中 或 者 验证 器 类 中 添加 这 些 信息 ,然后 在 JSP 页 面 中 显示 输出 。 


先 看 一 个 Action 类 ,如 代码 6-28 所 示 。 
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代码 6-28 MessageAction. java 


Puiblic class Messagenction extends ActionSupport { 
Puiblic String execute ()throws Exoeption{ 


// 添 加 action 一 般 性 消息 
this.addActionMessage ("第 一 条 Rcticn 消 息 "); 
this.addActionMessage ("第 二 条 Action 消 息 "); 


// 添 加 action 错 误 消息 

this.addpctiongrror(" 第 一 条 zction 错误 消息 "); 
this.adqdctionError(" 第 二 条 Bction 错 误 消息 "); 

// 添 加 field 级 错误 信息 

this.adoFieldError ("fieldi", "第 一 条 feld 级 错误 "); 
this.addFieldPrror("field2"，" 第 二 条 field 级 错误 "); 


retum SUOCESS; 


上 述 代 码 利用 了 ActionSupport 类 提供 的 addActionMessage() 和 addActionError() 
向 Action 级 添加 一 般 性 信息 和 错误 信息 ,利用 addFieldError() 方 法 为 特定 属性 添加 错 
误 信息 。 

代码 6-29 给 出 的 message. jsp 页 面 显示 了 上 述 信 息 。 


代码 6-29 ”message. jsp 页 面 


<s:fom> 
<h3> 输 出 action 信息 < /h3> 
< s:actionmessage/> 


<h3> 输 出 Action 错 误 < /h3> 


< 3:actionerror/> 


<h3> 输 出 所 有 字段 错误 < /h3> 
< s:fielderror> < /s:fielderror> 


<h3> 输 出 fieldl 字段 错误 < /h3> 
<s:fielderror> 
< s:parany fieldl< /s:param> 
</s:fielderror> 
</s:fom> 


注意 : fielderror 标签 和 param 标签 结合 可 以 显示 特定 属性 的 错误 。 在 浏览 器 中 访 
问 MessageAction ,可 以 看 到 如 图 6-19 所 示 的 输出 。 


固 :ction tag exmple 
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4 CUIO127.0.0.1 
输出 Action 信 息 


。 第 一 条 Action 消 息 
。 第 二 条 Action 消 息 


输出 Action 错 误 


。 第 一 条 Action 错 误 消息 
。 第 二 条 Action 错 误 消 息 


输出 所 有 字段 错误 


。 第 一 条 field 级 错误 
。 第 二 条 人 field 级 错误 


输出 field1 字 段 错误 
。 第 一 条 field 级 错误 


6/nessage. acti iN 


图 6-19 ”actionerror、actionmessage 和 fielderror 标签 在 浏览 器 中 的 输出 效果 


67 模板 和 主题 


先 来 看 一 个 登录 页 面 的 代码 片段 。 


< s:fom action= "login.action" id= "framl" > 
< 3:textfield name= "username" size= "40" label= "用 户 名 


"™ 


< s:password name= "password" size= "40" label= "密码 "> < /s:password> 
< 3:checkbox name= "remenber" label= " 记 住 密码 " > < /s:checkbox> 


<s:submit value= "登录 "></s:submit> 
< s:reset type= "input" value= " 重 填 ">< /s:reset> 

< /s:fom> 

在 浏览 器 中 观察 上 述 代码 的 输出 效果 ,如 图 6-20 
所 示 。 

之 所 以 能 够 看 到 这 样 的 布局 效果 ,是 因为 Struts 2 
在 将 上 述 表单 转换 成 HTML 代码 时 ,利用 一 种 叫做 主 
题 的 技术 进行 泻 染 。 

主题 和 模板 是 Struts 2 UI 标签 的 核心 ,模板 是 一 
个 UI 标签 的 外 在 表示 形式 。 例 如 ,上 面 的 例子 中 使 用 
了 checkbox 标签 ,Struts 2 根据 对 应 的 checkbox 模板 
生成 一 个 有 模板 特色 的 复 选 按钮 。Struts 2 支持 
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用 户 名 : [ 


密码 : | 
口 记 住 密码 


图 6-20 采用 默认 主题 的 登录 页 面 


FreeMarker、Velocity 和 JSP 模板 引擎 ,默认 情况 下 使 用 的 是 FreeMarker 模板 。 也 就 是 
说 ,Struts 2 提供 的 UI 标签 的 模板 都 是 使 用 FreeMarker 编写 的 。 所 有 UI 标签 对 应 的 


模板 形成 了 一 个 主题 。 


当 要 改变 UI 标 签 的 外 观 时 ,可 以 直接 设置 该 UI 标签 需要 使 用 的 模板 ,也 可 以 设置 
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该 UI 标 签 使 用 的 主题 。 通 常 ,不 推荐 直接 设置 模板 属性 ,而 是 选择 特定 主题 。 可 以 通过 
以 下 几 种 方法 设置 一 个 UI 标签 的 主题 。 

(1) 通过 设 定 某 个 UI 标签 上 的 theme 属性 来 指定 主题 。 

(2) 通过 设 定 某 个 UI 标签 外 围 的 Form 标签 的 theme 属性 来 指定 主题 。 

(3) 通过 取得 page 会 话 范围 内 以 theme 为 名 称 的 属性 来 确定 主题 。 

(4) 通过 取得 request 会 话 范围 内 以 theme 为 名 称 的 属性 来 确定 主题 。 

(5) 通过 取得 session 会 话 范围 内 以 theme 为 名 称 的 属性 来 确定 主题 。 

(6) 通过 取得 application 会 话 范围 内 以 theme 为 名 称 的 属性 来 确定 主题 。 

(7) 通过 取得 名 为 struts. ui. theme 的 常量 (默认 值 是 xhtml) 来 确定 主题 。 该 常量 可 
以 在 struts. properties 文件 或 者 struts. xml 文件 中 确定 。 

对 于 上 面 介 绍 的 几 种 指定 UI 标 签 主题 的 方式 ,其 优先 级 与 上 述 顺 序 一 致 。 

Struts 2 提供 了 四 种 主题 。 

(1) simple 主题 : simple 主题 将 UI 标签 直接 转换 成 对 应 的 HTML 元 素 ,不 加 任何 
修饰 。 在 使 用 simple 主题 时 ,UI 标 签 的 部 分 属性 将 不 起 作用 。 

(2) xhtml 主题 : xhtml 主题 是 Struts 2 的 默认 主 
题 , 它 采用 一 个 具有 两 列 的 table 布局 form 表单 。 每 
个 UI 标 签 占据 表 中 的 一 行 。 其 中 UI 的 label 标签 显 
示 的 属性 占据 第 一 列 ,UI 标签 对 应 的 HTML 元 素 占 | 甩 名 : ] 
据 第 二 列 。 在 测试 上 述 表单 的 代码 时 ,可 以 通过 浏览 | zen 一 一 
器 提供 的 查看 源码 功能 查看 输出 到 客户 端的 源码 。 [EEE 

为 使 图 6-20 中 的 表单 布局 更 美观 一 些 ,可 以 将 代 
码 修改 成 下 述 形 式 。 修 改 后 ,“ 登 录 ” 和 “ 重 填 ” 按 钮 位 
于 同一 行 ,如 图 6-21 所 示 。 图 6-21 修改 标签 主题 后 的 登录 页 面 
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< 3:fom acticn= "Jogin.action" id= "froml" > 
< s:textfield name= "username" size= "40" label= 用 户 名 "/> 
< s:password namer "password" size= "40" label= "密码 "> < /s:password> 
< s:checkbox name= "remenber" label= " 记 住 密码 " > < /s:checkbox> 
<tr> 
<td</td> 
<t 中 
<s:submit value= "登录 " theme= "simple"> < /s:sutmit> 
<s:reset type= "input" value= " 量 填 " theme= "simple"> < /s:reset> 
</td 
</tr> 
< /s:fom> 


(3) css_xhtml 主题 : 该 主题 类 似 于 xhtml 主题 ,但 是 采用 CSS 和 DIV 实现 布局 和 
排版 。 

(4) ajax 主题 : 在 xhtml 主题 的 基础 上 增加 了 一 些 高 级 的 Ajax 功能 。 该 主题 自 提 
出 到 现在 ,一 直 处 于 实验 阶段 。 
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在 实际 开发 时 ,有 经 验 的 开发 人 员 一 般 都 会 使 用 simple 主题 ,然后 通过 定义 自己 的 
CSS, 利 用 DIV 实现 页 面 的 布局 。 


68 案例 3: 用 Siuts 2 标签 库 改写 留言 板 的 视图 


本 节 将 利用 Struts 2 标签 改写 留言 板 程序 的 各 个 JSP 页 面 。 
1 公共 文件 headerjsp 
公共 文件 header. jsp 用 于 输出 程序 的 LOGO 以 及 欢迎 信息 ,如 代码 6-30 所 示 。 


session 中 的 user 对 象 是 login. action( 见 第 5 章 代 码 5-23) 在 完成 对 用 户 的 身份 验证 后 保 
存 起 来 的 。 


代码 6-30 ”公共 文件 header. jsp 


< $Q page language= "java" pageEncoding- "UTF- 8"%> 
< %@ taglib uri= "/struts- tags" prefix= "s" $> 
<div class= "header"> 
<div class= "welomePanel"> 
<3:if test= "null!=# 3essicn.user.userName"> < !-- 测 试用 户 是 否 登录 --> 
欢迎 < s:property value= 叶 3ession.user.userName" /> 回来 
< img alt= mm srcr= "imeges/split.jpg"> 
<a href- "Jogout.action"> 登 出 < /a> 
</s:if> 
</div> 
</div> 


注意 : 由 于 header. jsp 需要 被 包含 在 index. jsp、detail. jsp 和 post. jsp 中 ,而 这 些 文 
件 中 已 经 引入 了 Struts 2 标签 库 , 因 此 可 以 省 略 taglib 指令 。 当 省 略 时 ,其 他 页 面 只 能 使 
用 语句 。 

< %@ include file= "header.jsp" $> 
来 包含 header. jsp, 而 不 能 使 用 <jsp:include 记 指令 或 者 Struts 2 的 include 标签 ,否则 登 
录用 户 名 将 无 法 显示 出 来 。 

2 留言 列表 indexjsp 

留言 列表 index. jsp 是 listNotes. action 在 返回 结果 码 为 SUCCESS 时 的 视图 页 面 ， 
它 通过 iterator 标签 迭代 输出 listNotes 实例 的 notes 列表 ,如 代码 6-31 所 示 。 

代码 6-31 留言 列表 index. jsp 


< $Q@ page language= "java" pageEnooding= "UTE- 8"%> 
< %Q taglib uri= "/struts- tags" prefix= "s" $> 
<html> 
<head> 
<title> 留 言 列表 < /title> 
< Link rel= "stylesheet" typer "text/css" href- "style/main.css"> 
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< /head> 
<body> 
< %@ include filer "header.jsp" $> 
<a href= "addNote.action"> < img src= "images/book write.png"/>< /a> 
< div class= ri- widbet- header" style- "text- align:osnter;"> 留 言 列表 
</div> 
<div class= "co11"> 留言 人 < /div> 
<div class= "co12"> 主题 < /div> 
< !-- 迄 代 输 出 Action 的 notes 属 性 一 > 
< 3:iterator valuer "notes" var= "note"> 
<div class= "clear"> < /div> 
<div class= "col1">< !- 用 属性 标签 输出 留言 人 的 姓名 --> 
< s:property value= # note.user.userName"/> 
</div> 
<div class= "ool2"> 
< 上 -用 a 标 签 构造 留言 内 容 的 URL, 注 意 其 中 "%" 的 用 法 --> 
< s:a href= "detail.actionanoteId=%{# note.noteId}"> 
< s:property value= 啡 note.title"/>< /s:a> 
</div> 
< /s:iterator> 
< /body> 
< /html> 


3 留言 页 面 postjsp 
post. jsp 页 面 需要 为 用 户 提供 一 个 书写 新 留言 的 接口 ,这 里 使 用 Struts 2 的 UI 标签 
编写 表单 。Struts 2 默认 的 主题 为 xhtml, 但 由 于 目前 很 少 采 用 表格 形式 进行 布局 ,所 以 这 
里 将 表单 的 主题 设置 为 simple, 并 采用 CSS 和 DIV 进行 布局 。 代 码 6-32 给 出 了 post jsp 的 
样 例 。 
代码 6-32 ”留言 页 面 post. jsp 


< $@ page language= "java" pageEnooding= "UIF- 8"%> 
< %@ taglib uri= "/struts- tags" prefix= "s" %> 
<html> 
<head> 
<title> 新 留言 < /title> 
< link rel= "stylesheet" type= "text/css" href- "style/main.css"> 
< !--kindeditor 配置 --> 
< script charset= "utf- 8" src= "kindeditor/kindeditor- min.js"> < /script> 
< script> 
Var editor; 
KindPditor.ready (functicn (K) { 
editor=K.create ("textarea [name= "note.content"]" 
); Ds; 
< /script> 
< /head> 
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<body> 
< $@ include file= "header.jsp" $> 
< div class= ui- widget— header" style- "text- align:osnter;"> 新 留言 
</div> 
< 5:fom actionr "adoNote.action" theme= "simple"> 
<div class= "co11> 标 题 < /div> 
< div class= "col2"> 
< s:textfield name= "note.title" size= "50"> 
< /s:textfield> 
</div> 
<div class= "clear"> < /div> 
<div class= "co11"> 内 容 < /div> 
<div class= "co12"> 
< 3:textarea rows= "20" cols= "60" name= "note.content"> 
< /s:textarea> 
纱 于 1000 字 ) 
</div> 
<div class= "0012"> 
<s:sutmit value= 哺 定 ">< /s:simit> 
<s:reset value= " 重 填 ">< /s:reset> 
</div> 
</s:fom> 
< /body> 
< /himl> 


上 述 代 码 中 使 用 了 kindeditor html 在 线 编辑 器 将 textarea 标签 替换 为 一 个 富 文 
本 输入 框 ,使 得 用 户 可 以 通过 所 见 即 所 得 的 方式 对 留言 内 容 格式 化 ,从 而 提供 更 为 友 
好 的 输入 界面 。 在 使 用 kindeditor 时 ,需要 首先 从 http://www. kindsoft. net/ 获 取 
kindeditor 压缩 包 , 将 其 解压 并 存放 在 webroot 的 kindeditor 目录 下 ,然后 在 需要 为 用 户 
提供 富 文 本 输入 的 页 面 ,使 用 如 下 格式 将 一 个 HTML 的 textarea 标签 转换 成 HTML 编 
辑 器 。 
< script charset= "utf_ 8" sro= "kindeditor/kindeditor_ min.js"> < /script> 
< script> 
var editor; 
KindEditor.ready (finction (K) {editor= 
K.create ('textarea [name= "note.content"] "); }); 
< /script> 
注意 : 其 中 的 name 属性 值 一 定 要 和 textarea 标签 的 name 属性 值 相同 。 
图 6-22 给 出 了 留言 页 面 的 浏览 效果 。 
读者 可 以 尝试 着 利用 xhtml 主题 对 留言 页 面 进行 布局 。 另 外 ,由 于 login. jsp 页 面 和 
detail. jsp 页 面 的 布局 比较 简单 ,这 里 不 再 给 出 ,读者 可 以 尝试 着 自己 完成 。 
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图 6-22 留言 页 面 


同步 训练 


1. 利用 Struts 2 标签 为 留言 板 程序 编写 注册 页 面 、 登 录 页 面 login. jsp 和 显示 留言 
页 面 detail. jsp, 要 求 分 别 应 用 simple 主题 和 xhtml 主题 。 
2. 使 用 Struts 2 标签 编写 站 内 短信 系统 的 视图 页 面 。 
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7? 拦 稚 器 


71 Struts 2 拦截 器 


拦截 器 (Interceptor) 是 Struts 2 最 重要 的 特性 之 一 , 它 类 似 于 Servlet 的 过 滤器 以 及 
Java 中 的 Proxy 类 。 通 过 拦截 器 ,程序 员 可 以 在 Action 方法 执行 前 后 以 及 在 Result 执 
行 之 后 进行 一 些 功能 处 理 ,例如 身份 验证 .日 志 处 理 等。 读者 可 以 回想 一 下 第 5 章 给 出 
的 Struts 2 体系 结构 图 中 关于 拦截 器 的 部 分 。 

与 Servlet 过 滤器 不 同 的 是 ,拦截 器 的 功能 更 为 强大 。 拦 截 器 与 Servlet 的 API 无 
关 , 并 且 能 够 访问 Value Stack 中 的 内 容 。 事 实 上 ,Struts 2 框架 提供 的 很 多 特性 都 是 通 
过 拦截 器 实现 的 ,例如 Action 属性 值 的 注入 、 异 常 处 理 、 文 件 上 传 、 生 命 期 回调 和 输入 校 

Struts 2 中 预定 义 了 大 约 30 多 个 拦截 器 ,这 些 拦截 器 都 定义 在 struts-default. xml 
文件 的 struts-default 包 内 ,程序 员 可 以 在 struts. xml 中 直接 引用 这 些 拦截 器 。 下 面 简单 
介绍 比较 常见 的 几 个 拦截 器 。 

(1) chain 拦截 器 : 将 前 一 个 执行 结束 的 Action 的 属性 复制 到 当前 的 Action 中 , 完 
成 了 result 映射 中 的 chain 结果 类 型 的 映射 。 

(2) checkbox 拦截 器 : 添加 了 对 checkbox 自动 处 理 代码 。 当 检测 到 checkbox 未 选 
择 时 ,将 自动 将 其 设 定 为 false。 

(3) conversionError 拦截 器 : 将 存储 在 ActionContext 中 的 类 型 转化 错误 信息 取出 
来 ,添加 到 相应 的 Action 的 字段 错误 中 。 

(4) execption 拦截 器 : 提供 异常 处 理 ,允许 程 序 员 把 一 个 异常 映射 到 一 个 结果 码 。 

(5) execAndWait 拦截 器 : 当 一 个 Action 执行 时 间 很 长 时 ,该 拦截 器 可 以 让 Action 
到 后 台 执行 ,并 提供 给 用 户 一 个 友好 的 进度 信息 。 

(6) fileUpload 拦截 器 : 用 于 提供 对 文件 上 传 的 支持 。 

(7) il8n 拦截 器 : 用 于 支持 国际 化 。 它 能 够 将 当前 会 话 选择 的 locale 放 到 用 户 的 
session 中 。 

(8) logger 拦截 器 : 用 于 在 日 志 信息 中 输出 要 执行 的 Action 信息 。 程 序 员 在 调试 程 
序 时 ,能 够 很 快 地 定位 到 对 应 的 Action。 

(9) modelDriven 拦截 器 : 当 Action 实现 ModelDriven 接口 时 . 它 将 getModel() 取 
得 的 模型 对 象 存 人 Value Stack 。 
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(10) params 拦截 器 : 负责 将 请 求 参 数 映射 到 Action 的 同名 属性 上 。 

(11) scope 拦截 器 : 将 Action 状态 保存 到 session 或 application 范围 。 

(12) servletConfig 拦截 器 : 提供 Action 直接 对 Servlet API 的 访问 ,把 Servlet API 的 
对 象 注入 Action, 包 括 : ServletRequestAware、 ServletResponseAware、 ParameterAware、 
ApplicationAware 和 Session Aware。 

(13) validation 拦截 器 : 调用 验证 框架 读 取 xxxAction-validation. xml 文件 ,并 执行 
在 这 些 文件 中 声明 的 校 验 。 

(14) timer 拦截 器 : 输出 ActionInvocation 余下 部 分 执行 的 时 间 , 便 于 寻找 性 能 
瓶颈 。 
(15) token 拦截 器 : 用 于 检查 传 到 Action 中 的 token 的 有 效 性 ,用 于 避免 表单 重复 
提交 。 

(16) tokenSession 拦截 器 : 功能 与 token 类 似 ,但 它 把 提交 的 数据 保存 到 session 
中 。 引 用 该 拦截 器 可 以 防止 页 面 重复 提交 。 
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除了 可 以 使 用 Struts 2 提供 的 拦截 器 外 ,程序 员 还 可 以 编写 自己 的 拦截 器 。 自 定义 
拦截 器 时 ,可 以 实现 com. opensymphony. xwork2. interceptor. Interceptor 接口 。 

Interceptor 接口 中 定义 了 三 个 方法 。 

(1) void init(): 该 方法 在 对 象 初始 化 时 被 调用 ,用 于 初始 化 拦截 器 需要 的 资源 。 

(2) void destroy(): 用 于 释放 拦截 器 占用 的 资源 ,类 似 于 C++ 中 的 析 构 函数 。 

(3) String interceptor( ActionInvocation invocation) : interceptor() 方 法 是 真正 实现 
拦截 器 功能 的 方法 , 自 定义 拦截 器 主要 就 是 实现 这 个 方法 。 该 方法 具有 唯一 的 参数 
invocation, 它 是 ActionInvocation 的 一 个 实例 ,第 5 章 中 曾经 说 过 ,ActionInvocation 负 
责 调度 Interceptor、Action 和 Result, 它 握 有 Action Context, 因此 能 够 很 方便 地 访问 
Value Stack 中 的 内 容 。 图 7-1 所 示 为 Struts 2 官方 文档 中 给 出 的 一 个 关于 拦截 器 、 
Action、Result 和 Action Context 之 间 的 关系 。 

代码 7-1 给 出 一 个 自 定义 拦截 器 的 例子 。 

代码 7-1 自 定义 拦截 器 


Package example.Interceptory 

jimport com.apensyrphony.xwork2.RctionTnvocaticny 

jimport om.opensyrphony .xwork?2. interosptor. Interosptor; 

Public class TestInterceptor implements Interosptor { 
Private String icNeme; 


/* 省 上 略 了 get 和 set 方 法 */ 


piblic String intercept (ActionInvocation arg0) throws Excepticn { 
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System.out .println (icNamet ":Action 还 没有 执行 !"); 
String resultCode= arg0.irvoke (); 
System.cut.println (icName+ ":Action 已 经 执行 结束 1!"); 
retum resultCode; 

} 


Eublic void destroy() { 
System.out.println (icNamet ": 拦 截 器 结束 "); 
} 


piblic void init () { 


System.cut.println (icName+ ": 拦 截 器 开始 "); 
} 


请 求 
An 结束 


拦截 器 栈 


invoke result 
Action Result 
OGNL 


OGNL 


1 


ValueStack request | Session 


Action Context (ThreadLocal ) 


图 7-1 拦截 器 、Action、Result 和 Action Context 之 间 的 关系 

在 interceptor() 方 法 中 的 语句 

String resultOode= arg0.invoke (); 
负责 将 用 户 请 求 向 下 传递 ,并 获得 后 续 操 作 返 回 的 结果 码 。 当 这 条 语句 被 删除 时 ,后 续 
的 拦截 器 Action 和 Result 不 会 被 执行 。 在 有 些 情况 下 ,拦截 器 可 能 希望 阻止 一 个 
Action 执行 ,例如 重复 提交 的 情况 下 或 者 校 验 没 有 通过 的 情况 下 ,此 时 可 以 不 让 拦截 器 
去 执行 arg0. invoke() 。 

除了 实现 Interceptor 接口 外 ,还 可 以 扩展 Interceptor 的 默认 实现 类 。 

Com.cpensymphony.xwork2.interceptor.RbstractInterceptor 

如 果 和 希望 自 定义 的 拦截 器 只 拦截 Action 中 指定 的 方法 ,或 者 不 拦截 某 些 方法 ,需要 
使 用 Struts 2 提供 的 一 个 特殊 拦截 器 抽象 基 类 。 


太 > Web 应 用 程序 开发 技术 一 JSP 十 Struts 2 


camapensymrghony.xwork2.interceptor.MEthodFilterInterceptor 

很 多 拦截 器 都 是 从 MethodFilterInterceptor 上 扩展 来 的 ,例如 ValidationInterceptor、 
TokenInterceptor 和 ParametersInterceptor 等 。 该 拦截 器 具有 两 个 参数 。 

(1) excludeMethods: 要 排除 的 方法 列表 ,多 个 方法 时 用 逗号 ", ”分隔 。 

(2) includeMethods: 要 拦截 的 方法 列表 ,多 个 方法 时 用 逗号 *, ”分隔 。 
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Struts 2 拦截 器 需要 在 struts. xml 中 声明 。 在 配置 struts. xml 时 ,只 要 package 是 
从 struts-default 继承 ,package 就 会 自动 拥有 struts-default. xml 中 的 所 有 配置 ,包括 默 
认 的 拦截 器 。 
自 定义 拦截 器 的 声明 应 该 使 用 interceptor 元 素 , 并 将 interceptor 元 素 放 在 
interceptors 元 素 里 。 格 式 如 下 : 
< interceptors> 
< interceptor name= 只 截 舒 名 1 " class= 岂 截 豆 的 实现 类 1 "> 
< interceptor name= 只 截 导 名 2 " class= 习 截 豆 的 实现 类 2 "> 


< /interoeptors> 


如 果 要 为 某 个 Action 应 用 声明 好 的 拦截 器 ,需要 在 Action 元 素 中 使 用 interceptor- 
ref 元 素 。 

例如 ,现在 有 一 个 Action 类 ,如 代码 7-2 所 示 , 可 以 为 该 Action 添加 一 个 拦截 器 
TestInterceptor( 见 代码 7-1) 。 在 strus2. xml 中 ,按照 代码 7-3 所 示 方 法 进行 配置 。 


代码 7-2 示例 Action 类 


Package exanple.action; 

jimport ccm.apensyrphony.xwork2.RctionSupport7 

Public class ICAction extends ActionSupport { 
Public String execute (){ 


System.out.println (" 正 在 执行 Bcticn."); 
Teturn SUOCESS; 


代码 7-3 ”声明 和 使 用 拦截 器 


< package name= "default" namespace= "/" extends= "struts- default"> 
< 一 -声明 一 个 拦截 器 icl --> 
< :interceptors> 
< interceptor neme= "icln 
Class= "exzmple.Interceptor.TestInterceptorn> 
< /interceptor> 
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< /interceptors> 
<! 一 在 acticn 中 应 用 拦截 器 ,并 为 拦截 器 注 和 人 参数--> 


<action name= "ic" class= "example.action.ICRction> 
< result type= "redirectAction"> list< /result> 


上 述 代 码 在 声明 拦截 器 的 同时 ,还 利用 param 元 素 将 拦截 器 的 icName 属性 赋值 为 
“icl"。 
当 一 个 Action 需要 使 用 多 个 拦截 器 时 ,可 以 将 这 些 拦截 器 组 合 在 一 起 ,组 成 一 个 拦 
截 器 栈 , 然 后 在 Action 中 利用 interceptor-ref 元 素 直 接 引用 拦截 器 栈 。 拦 截 器 栈 的 声明 
是 在 interceptors 元 素 中 使 用 interceptor-stack 完成 的 ,格式 如 下 : 
< interceptors> 
< interceptor- stack name= 叱 截 豆 栈 名 活 
< interceptor- re 人 喧 截 器 或 拦截 器 栈 名 1 " /> 
< interceptor name= 只 截 各 或 拦截 种 栈 名 2 "/> 
< interceptor- stack> 
< /interceptors> 


代码 7-4 给 出 了 拦截 器 栈 配置 和 引用 的 方法 。 
代码 7-4 声明 和 引用 拦截 器 术 


< package name= "ic" namespaoe= "/" extends= "struts- default"> 
< 二 -声明 一 个 拦截 器 icl --> 
< interceptors> 
< interceptor name= "icl" 
Class= "exanple. Interosptor.TestInterosptor"> 
< /interceptor> 


<!-- 声 明 一 个 拦截 器 栈 ic --> 


</interceptcr- ref> 
<!-- 引 用 默认 拦截 器 栈 --> 
< interceptor- ref neme= "defaultStack"> < /interceptor- ref> 
< /interceptor- stack> 
< /interceptors> 


18 和 > Web 应 用 程序 开发 技术 一 -JSP+Struts 2 


< 上 -在 acticn 中 应 用 拦截 器 一 > 
< action name= "ic" classr "example.action.TICnctionr> 
< result> /sucoess.jsp< /result> 
< interceptor- ref name= "ic"> < /interceptor- ref> 
< /action> 
< /package> 


上 述 代 码 配 置 了 一 个 拦截 器 栈 ic, 栈 中 包括 两 个 拦截 器 和 一 个 拦截 器 栈 
defaultStack 。 

(1) 在 声明 拦截 器 时 可 以 同时 为 拦截 器 的 参数 赋值 。 如 果 在 声明 和 应 用 拦截 器 时 都 
为 同一 个 参数 赋 了 值 ,起 作用 的 将 是 应 用 拦截 器 时 的 参数 值 。 

(2) defaultStack 是 Struts 2 框架 的 默认 拦截 器 
栈 , 包 含 exception ,alias 等 18 个 拦截 器 。 当 为 一 个 Cn 
Action 配置 了 interceptor-ref 元 素 时 ,如 果 所 引用 的 jas 
拦截 器 栈 中 没有 包含 对 defaultStack 的 引用 ,Struts 2 icl:Action 还 没有 执行 ! 
无 法 为 Action 完成 属性 映射 等 功能 。 因 此 ,一 般 情况 | “Acion 还 没有 执行 


正在 执行 Action. 
下 ,在 为 一 个 Action 配置 自 定义 的 拦截 器 或 拦截 器 栈 | cAction 忆 经 加 行 结 来! 


时 ,一 定 不 要 忘记 引用 defaultStack。 icl:Action 已 经 执行 结束 ! 
(3) 位 于 拦截 器 栈 中 的 拦截 器 的 顺序 非常 重要 ， 1 二 后 
它 直接 决定 了 拦截 器 执行 的 顺序 。 例 如 ,启动 ic2: 搓 截 器 结 
Tomcat 服务 器 ,在 浏览 器 中 请 求 ic. action ,而 后 关闭 
Tomcat, 可 以 从 控制 台 得 到 如 图 7-2 所 示 的 输出 (省 图 7-2 拦截 器 运行 输出 
略 了 Tomcat 其 他 输出 信息 ) 。 
为 了 使 读者 看 得 更 清晰 ,在 图 7-3 给 出 了 ic. action 执行 时 拦截 器 .Action 类 和 
Result 的 序列 图 。 


Struts2 拦截 器 IC1 拦截 器 IC2 ic.action Result 


T 
1 
1 
interceptor() | 


T 
1 1 
1 1 
1 1 
1 1 
interceptor | 
1 
1 
h 


execute() 


图 7-3 拦截 器 栈 的 执行 顺序 


根据 ic. action 执行 情况 .可 以 得 知 : 
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(1) Struts 2 框架 装 在 加 载 struts. xml 时 ,执行 拦截 器 的 init() 方 法 ; 
(2) 同一 拦截 器 栈 中 , 先 配置 的 拦截 器 先 执行 ,后 配置 的 拦截 器 后 执行 ; 
(3) Struts 2 框架 在 印 载 前 、 后 执行 拦截 器 的 destroy() 方 法 。 
如 果 多 个 Action 都 要 引用 相同 的 拦截 器 ,可 以 使 用 default-interceptor-ref 元 素 定 义 
一 个 默认 的 拦截 器 或 拦截 器 栈 ,这 样 就 不 需要 为 每 个 Action 都 指定 拦截 器 引用 了 。 
代码 7-5 给 出 了 默认 拦截 器 和 拦截 器 栈 的 声明 方法 。 
代码 7-5 配置 默认 的 拦截 器 栈 


< package name= "ic2" namespacer= "/" extends= "struts- default"> 
< !-- 声 明 一 个 拦截 器 icl --> 
< interceptors> 
< interosptor name= "icln 
Class= "example.Interceptor.TestInterceptor"> 
< /interoeptor> 


< ! 一 声明 一 个 拦截 器 栈 ic --> 
< interceptor- stack name= "ic"> 
< interosptor— ref name= "icl"> 
< param name= "icName"> icl< /param> 
< /interoeptor- re 人 


< !-- 引 用 默认 拦截 器 栈 --> 
< interceptor- ref name= "defaultStack"> < /interceptor- ref> 
< /interceptor- stack> 
< /interceptors> 


<!-- 配 置 默 认 的 拦截 器 和 拦截 器 栈 引 用 --> 
< default- interceptor- ref neme= "ic"> < /default- interceptor- re 人 


< 上 -在 action 中 应 用 默认 拦截 器 和 拦截 器 栈 --> 

<action name= "ic" class= "exanple.action.ICAction"> 
< result> /success.jspx< /result> 

< /action> 


< !--icl.action 中 默认 的 拦截 器 和 拦截 器 栈 不 会 起 作用 一 > 
< action name= "icl" class= "exanple.action.ICAction"> 
< result> /sucoess.jsp< /result> 
< interceptor- ref neme= "icl"> < /interceptor- ref> 
< /action> 
< /package> 


在 上 述 配 置 中 ,有 多 个 地 方 配置 了 拦截 器 ,那么 Struts 2 框架 会 按 如 下 顺序 查找 一 个 
Action 引用 了 哪些 拦截 器 。 

(1) 查找 当前 Action 是 否 声明 了 拦截 器 .如果 有 , 则 使 用 这 个 拦截 器 ,不 再 继续 寻 
找 ;如 果 没 有 ,执行 下 一 步 。 

(2) 查找 当前 Action 所 在 的 package 中 是 否 使 用 default-interceptor-ref 声明 了 默认 
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的 拦截 器 引用 。 如 果 有 ,就 使 用 它 ,不 再 继续 寻找 :如果 没 有 ,执行 下 一 步 。 
(3) 递归 寻找 Action 所 在 包 的 父 包 中 是 否 设 置 了 默认 拦截 器 引用 ,直到 找到 为 止 。 
因此 ,在 代码 7-5 给 出 的 配置 中 ,ic. action 将 被 应 用 默认 的 拦截 器 栈 ic, 而 icl. action 
由 于 利用 interceptor-ref 进行 了 重新 配置 ,因此 默认 拦截 器 将 不 发 生 作 用 ,这 也 就 是 为 什 
么 我 们 一 青 强调 ,在 配置 自 定义 拦截 器 时 不 要 忘记 引用 defaultStack 的 原因 。 


74 ”PreResultListener 接口 


PreResultListener 是 一 个 监听 器 接口 , 它 可 以 在 Action 完成 控制 处 理 之 后 , Result 
执行 之 前 被 回调 。 

PreResultListener 接口 只 有 一 个 方法 。 

Void beforeResult (ActionInvocation invocation, String resultCode) 

resultCode 是 Action 执行 返回 的 结果 码 。 该 方法 在 Action 执行 之 后 , Result 执行 
之 前 执行 。 

代码 7-6 所 示 是 添加 了 PreResultListener 监听 器 的 TestInterceptor 拦截 器 类 。 

代码 7-6 添加 了 PreResultListener 监听 器 的 TestInterceptor 拦截 器 类 


Package exarple. Interosptor; 


jimport om.opensyrphony .xwork2.ActionInvocation; 
jimport om.opensyrphony .xwork?.interoeptor .AbstractInteroaptor; 
jimport om.opensyrphony .xwork2. interoeptor.PreResultListener; 


Pblic class TestInterceptor extends AbstractInterosptor { 
Private String icName; 
/* 省 略 了 get 和 set 方 法 * / 


Public String interospt (ActionInvocation arg0) throws Exosption { 
System.out.println (icName+ ":Action 还 没有 执行 !"); 


arg0.addPreResultListener (new PreResultListener (){ 
Public void beforeResult (ActionInvocation arg0，String argl) { 
System.cut.println (icName+ ":beforeResult 方 法 被 调用 ， 
Action 已 经 执行 完毕 "); 
} 
D; 
String resultCode= arg0.imvoke (); 
System.cut.println (icName+ ":Action 和 Result 已 经 执行 结束 !"); 
retum resultCode; 


} 


注意 : PreResultListener 监听 器 一 定 要 在 invoke() 方 法 被 调用 之 前 注册 ,否则 
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beforeResult 将 无 法 被 调用 。 

采用 代码 7-4 中 的 拦截 器 配置 ,利用 ic. action 测试 上 述 拦截 器 ,可 以 得 到 如 图 7-3 所 
示 的 输出 结果 。 可 以 看 到 ,beforeResult() 方 法 在 Action 被 执行 之 后 ,Result 被 执行 之 前 
被 调用 。 


icl:Action 还 没有 执行 ! 

正在 执行 Action. 

icl:beforeResult 方 法 被 调用 ，Action 已 经 执行 完毕 
icl:Action 和 Result 已 经 执行 结束 ! 


图 7-4 TestInterceptor 运行 输出 


75 案例 4: 利用 拦截 器 为 留言 板 增加 身份 验证 功能 


通过 案例 2 和 案例 3, 一 个 基于 Struts 的 留言 板 程序 已 经 具备 了 雏形 。 然 而 ,如 果 一 
个 未 登录 的 用 户 直接 从 浏览 器 访问 listNotes. action 或 detail. action?noteld 王 1 ,能够 成 
功 查 看 到 所 有 留言 列表 以 及 每 条 留言 的 内 容 。 本 节 将 利用 拦截 器 为 留言 板 增加 身份 验 
证 功能 。 当 用 户 访问 留言 板 中 的 页 面 时 ,拦截 器 将 截获 用 户 请 求 , 并 判断 用 户 是 否 已 经 
登录 。 如 果 没 有 登录 ,将 强制 在 浏览 器 显示 登录 页 面 ;如 果 用 户 已 经 登录 , 则 允许 用 户 访 
问 请 求 的 资源 。 

1 编写 身份 验证 拦截 器 

AuthenInterceptor 负责 判断 用 户 是 否 已 经 登录 。 如 果 用 户 已 经 登录 , 则 将 用 户 请 求 
传递 给 后 续 的 拦截 器 .Action 和 Result 的 调用 ;否则 ,返回 Action. LOGIN 结果 码 , 将 请 
求 重 定向 到 登录 页 面 。AuthenInterceptor 类 的 代码 如 代码 7-7 所 示 。 代 码 中 给 出 了 详 
尽 的 注释 ,在 此 不 再 袭 述 。 

代码 7-7 AuthenInterceptor 类 


Package notes.interosptor; 
import java.util .Map; 
jimport om.opensymphony .xwork2.* 7 
jimport om.cpensyrphony .xwork? .interoeptor .AbstractInteroeptor; 
Pblic class AuthenInterosptor extends AbstractInterosptor { 
Public String intercept (ActionInvocation arg0) throws Exosption { 


// 获 取 Actioncontext 上 下 文 ,也 可 以 使 用 arg0.getInvocaticncontext () 获 取 

ActionContext. context= RcticnContext.getContext (); 

/* 获取 sessionx / 

Map session= oontiext .getSession(); 

Cbject user= session.get ("user"); 

if(null==user) { /# 未 登录 ,返回 action.IoGIN 结 果 码 * / 
// 在 用 户 请 求 访问 的 acticn 中 添加 一 条 acticn 级 错误 ,也 可 以 不 加 
Actionsupport actionr (ActionSupport)arg0.getAction(); 
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action.addActionError ("您 尚未 登录 ,请 先 登 录 !"); 


Teturn Action.IOGIN; 

} 

else // 将 请 求 传递 给 后 续 的 拦截 器 .acticn 和 Result 调 用 
return arg0.invoke(); 


2 配置 Acion 和 拦截 器 
打开 留言 板 程序 的 配置 文件 struts. xml, 将 其 修改 成 代码 7-8 所 示 的 形式 。 


代码 7-8 留言 板 程序 的 struts. xml 


< ?ml version= "1.0" encoding= "UTF- 8" ?> 
< IDOCTYPE struts PUBLIC 
™ /apPache Software Foundation//DID Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts- 2.0.dtd"> 
<struts> 
< package name= "default" namespace= "/" extends= "struts- default"> 
<!-- 配 置 安全 认证 拦截 器 栈 --> 
< interceptors> 
< interceptor neme= "security" 
Class= "notes. interoeptor .AuthenInterosptor"> 
< /interceptor> 
< interceptor- stack neme= "auth"> 
< interceptor- ref neme= "defaultStack"> < /interoeptor- ref> 
< interceptor- ref neme= "security"> < /interceptor- ref> 
< /interceptor- stack> 
< /interceptors> 


<glcbal- results> 
< result name= "login"> WEB- INF/jsp/login.jsp< /result> 
</glabal- results> 


<!-- login 不 能 引用 拦截 器 栈 auth--> 
< action name= "login" class= "notes.action.LoginAction"> 

< result type= "redirectAction"> listNotes.action< /result> 
< /action> 


< action name= "logout" class= "notes.action.LoginAction" 
method= "logout"/> 
< /action> 


< 上 !-- 让 各 个 acticn 引用 拦截 器 栈 auth--> 

<acticn name= "listNotes" class= "notes.action.NotesAction" 
method= "list"> 
< result name= "sucoess"> WEB- INF/jsp/index.jsp< /result> 
< interceptor- ref neme= "auth"> < /interceptor- ref> 
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< /action> 

< action name= "adqNote" class= "notes.action.NotesAction" 
method= "agdd"> 
< result namer "sucosss" typer "redirectAction"> 

listNotes 

</result> 
< result name= "input"> WEB- INE/jsp/post.jsp< /result> 
< interceptor- ref name= "auth"> < /interceptor- ref> 

< /action> 

< action name= "detail" class= "notes.action.NotesAction" 
method- "detail"> 
< result name= "sucoess"> WEB- INFV/jsp/detai1.jsp< /result> 
< imterceptor- ref neme= "auth"> < /interceptor- ref> 

< /action> 

< /package> 
< /struts> 


注意 ; 绝对 不 能 为 login. action 配置 拦截 器 auth, 否 则 任何 用 户 都 将 无 法 登录 系统 。 
此 时 ,通过 浏览 器 ,在 未 登录 的 情况 下 访问 留言 板 程 序 中 的 资源 ,看 是 否 能 够 访问 
成 功 。 


同步 训练 


为 站 内 短信 系统 添加 身份 验证 功能 ,要 求 只 有 在 用 户 登 录 后 才能 访问 系统 资源 。 


hapter 8 
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81 文件 的 上 传 


811 文件 上 传 概述 


在 Web 应 用 程序 中 ,经 常 要 用 到 文件 上 传 功 能 。 例 如 ,在 一 个 Email 系统 中 ,需要 
提供 上 传 附件 的 功能 ;在 一 个 贴图 网 站 中 ,用 户 需要 利用 文件 上 传 将 本 地 的 图 片 贴 到 
网 上 。 

在 讨论 具体 的 文件 上 传 技术 之 前 ,首先 介绍 HTML 的 form 元 素 的 enctype 属性 。 
该 属性 用 于 指定 表单 数据 在 发 送 到 服务 器 之 前 应 该 如 何 编码 ,可 取 值 包括 : 

(1) application/x-www-form-urlencoded: 表单 数据 被 编码 成 “名 称 / 值 对 ”的 形式 ， 
这 是 默认 编码 方式 。 也 就 是 说 ,在 发 送 到 服务 器 之 前 ,所 有 字符 都 会 编码 (空格 转换 为 
“十 ”加 号 ,特殊 符号 转换 为 ASCII HEX 值 ) 。 

(2) multipart/form-data: 表单 数据 以 二 进 制 流 的 方式 传送 到 服务 器 。 这 种 编码 方 
式 把 文件 域 指定 的 文件 内 容 也 封装 到 请 求 参 数 里 。 在 使 用 包含 文件 上 传 控件 的 表单 时 ， 
必须 使 用 该 值 。 

(3) text/plain: 表单 数据 以 纯 文 本 形式 编码 ,其 中 不 含 任何 控件 或 格式 字符 。 这 种 
方式 主要 适用 于 直接 通过 表单 发 送 邮 件 。 

因此 ,为 了 成 功 上 传 文件 ,form 元 素 的 entype 属性 必须 设置 为 multipart/form- 
data。 男 外 ,form 元 素 的 method 属性 必须 设置 为 post, 这 是 因为 在 使 用 get 方式 提交 
时 ,表单 中 所 有 的 参数 都 附着 在 请 求 URL 的 后 面 ,而 URL 最 大 长 度 是 有 限制 的 ,通常 不 
超过 1KB; 而 在 post 方式 中 ,表单 请 求 数据 封装 在 HTTP Header 中 ,以 二 进 制 流 的 形式 
传送 到 Web 服务 器 。 因 此 ,一 个 提供 文件 上 传 功能 的 表单 , 它 在 浏览 器 中 看 到 的 源码 应 
该 具备 如 下 形式 : 


< fom action= ".." enctype= "mltipart/form data" method= "post"> 
< input type= "file" name=".." /> 
< /fom> 


默认 情况 下 , Struts 2 使 用 fileUpload 拦截 器 ,利用 Apache 提供 的 Common- 
FileUpload 组 件 实 现 文 件 上 传 。 该 组 件 的 优点 在 于 性 能 优异 ,支持 任意 大 小 文件 的 上 传 ， 
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程序 员 只 需要 编写 少量 的 代码 就 能 够 实现 文件 的 上 传 操作 。 

在 使 用 Common-FileUpload 组 件 上 传 文件 时 ,除了 需要 设置 好 表单 的 enctype 和 
method 属性 之 外 ,在 处 理 文件 上 传 请 求 的 Action 类 中 应 该 提供 三 个 特殊 命名 的 属性 。 
假设 表单 中 文件 选择 框 ( 二 input type 一 "file" name 一 "xxx" /二 ) 的 名 字 为 xxx, 那 么 
Action 类 中 应 该 提供 如 下 三 个 属性 。 

(1) xxx: 上 传 文件 对 象 .类 型 为 java. io. File。 

(2) xxxFileName: 上 传 文件 的 名 字 ,类 型 为 String。 

(3) xxxContentType: 上 传 文件 的 内 容 类 型 ,类 型 为 String。 

同时 ,需要 为 这 三 个 属性 定义 get 和 set 方法 。 


812 限制 上 传 文件 长 度 和 内 容 类 型 


fileUpload 拦截 器 负责 完成 文件 上 传 工作 。 这 个 拦截 器 已 经 包含 在 defaultStack 拦 
截 器 栈 中 ,只 要 确保 配置 Action 时 包含 了 这 个 栈 就 可 以 了 。fileUpload 拦截 器 有 两 个 重 
要 的 参数 ,对 文件 上 传 进行 控制 。 
(1) maximumSize: Action 可 接受 的 文件 的 最 大 长 度 ( 以 字 节 为 单位 )。 默 认 值 
为 2MB。 
(2) allowedTypes: 允许 上 传 内 容 类 型 的 列表 (例如 application/msword) ,各 类 型 之 
间 以 逗号 分 隔 。 当 没有 指定 时 ,Struts 2 将 允许 用 户 上 传 任意 类 型 的 文件 。 
如 果 读 者 对 内 容 类 型 不 熟悉 ,在 Tomcat 安装 目录 的 conf 子 目 录 中 有 一 个 web. xml 
文件 。 打 开 该 文件 ,将 看 到 很 多 mime-mapping 元 素 ,例如 : 
<mime- mapping> 
< extension> doc< /extension> 
< mime- type> application/mswordk /mime type> 
< /mime- mapping> 
这 里 的 extension 元 素 的 值 就 是 平时 所 说 的 文件 扩展 名 ,mime-type 就 是 该 扩展 名 的 
文件 类 型 对 应 的 内 容 类 型 ,allowedTypes 的 值 正 是 由 mime-type 构成 的 字符 串 。 
如 果 用 户 上 传 的 文件 大 小 超过 了 限定 值 或 者 文件 类 型 不 匹配 ,将 显示 一 条 错误 信 
息 。 该 错误 信息 定义 在 Struts 2-core-2. x. x. jar 的 struts-message. properties 中 ,包括 如 
下 几 个 II8N 键 。 
Struts.messages.error.uploading= Error uploading: {0} 

/文件 上 传 的 通用 错误 信息 
struts.messages.error.file.too.large= File too large: {0} "{1}" "{2}" {3} 

// 上 传 文件 超过 了 最 大 长 度 
struts.messages.error.content.type.not.allowedF Content- Type not alJbke 传 轴 冲 的 内 容 梁 型 不 允许 
程序 员 可 以 编写 自 己 的 错误 信息 文件 ,然后 在 struts. xml 中 利用 constant 标签 将 文 

件 名 赋值 给 常量 struts. custom. il8n. resources。 
需要 提醒 读者 的 是 ,fileUpload 拦截 器 只 是 在 文件 上 传 到 Web 服务 器 后 判断 文件 的 
大 小 是 否 超过 了 maximumSize 参数 的 值 ,如 果 希 望 在 文件 上 传 到 服务 器 之 前 就 进行 判 
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断 ,可 以 使 用 Struts 2 常量 来 设置 。Struts 2 中 提供 了 三 个 与 文件 上 传 有 关 的 常量 。 

(1) struts. multipart. parser: 用 于 指定 处 理 multipart/form-data 的 MIME 类 型 ( 文 
件 上 传 ) 请 求 的 框架 ,可 选 的 值 包括 cos、pell 和 jakarta, 分 别 对 应 使 用 cos 的 文件 上 传 框 
架 .pell 上 传 及 common-fileupload 文件 上 传 框架 。 该 属性 的 默认 值 为 jakarta。 

(2) struts. multipart. saveDir: 用 于 指定 上 传 文件 的 临时 保存 路 径 。 该 属性 的 默认 
值 是 javax. servlet. context. tempdir。 

(3) struts. multipart. maxSize: 用 于 指定 允许 上 传 的 文件 的 最 大 字 节 数 。 默 认 值 
为 2MB。 


813 上 传单 个 文件 
本 节 编 写 一 个 程序 ,介绍 在 Struts 2 中 如 何 实现 文件 上 传 。 


1 编写 文件 上 传 页 面 
新 建 一 个 upload.jsp 文件 ,内 容 如 代码 8-1 所 示 。 


代码 8-1 文件 上 传 页 面 (upload. jsp) 


< $0 page language= "java" pageEnooding= "UTF- 8"%> 
<htm> 
<head> 
<title> 上 传 文件 < /title> 
< /head> 
<body> 
< fam acticnr "uploed" enctype= "imltipart/fomm data" method- "post"> 
附件 :< input type= "file" name= "file"/> 
<input type= "aitmit" value= "提交 "/> 
< /fom> 
< /body> 
</htn> 


注意 : enctype 的 值 设 为 multipart/form-data,method 的 值 设置 为 post。 


2 编写 处 理 文件 上 传 的 Aio 类 
编写 用 于 处 理 文件 上 传 的 Action 类 ,如 代码 8-2 所 示 。 
代码 8-2 FileUploadAction. java 


Package exanple.action; 


jimport java.io.* ; 

jmport javax.servlet.ServletContext; 

inport org.apache.struts2.ServletActionContext; 

jimport om.cpensyrphony .xwork?2.ActionSupport; 

public class UploadFileAction extends ActionSupport { 
Private File file; // 代 表 上 传 文件 的 file 对 象 
Private String fileFileNeme; // 上 传 的 文件 名 
Private String fileContentType; // 上 传 文件 的 内 容 类 型 
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// 省 略 了 ge 和 set 方 法 


Public String execute () throws Exception { 
ServletContext context= ServletActionContext .getServletContext (); 
String dir= ontext .getRealPath ("/WEB_ INE™) ; // 获 取 /WEB- 2E 的 真实 路 径 


BufferedputputStream bos= null; 
BufferedInputStream bis=null; 


try{ 
FileInputStream fis=new FileInputStream(file); 
bis= new BufferedIrputStream(fis); 
FileOutputStream fos= new FileOutputStream(new File(dir, 
fileFileName)); 
bos= new BufferedoutputStream (fos); 


byte[] buf= new byte[4096]; 


int len= 一 17 
while ((len=bis.read(buf)) !=-1) { // 读 文件 
bos.write (ouf, 0, len); // 写 文件 
} 
} finally { 
try { 
if (null !=bis) 
bis.close(); // 关 闭 输入 流 


} catch (IOExcepticn e) { 

e.printStackTraoce (); 
} 
try{ 

if (oull !=bos) 

bos.close(); // 关 闭 输 出 流 

} catch (IOExcepticn e) { 

e.printStackTrace (); 


retum SUOCESS; 


提交 的 文件 被 上 传 到 Web 应 用 程序 的 WEB-INF 目录 下 ,新 文件 名 与 原始 文件 名 
相同 。 


3 配置 FleLhloadAcion 
在 struts. xml 中 配置 FileUploadAction ,如 代码 8-3 所 示 。 


代码 8-3 struts. xml 


< ?anl version= "1.0" encoding= "UIF- 8" 2> 
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< !DOCTYPE, struts PUBLIC 
™— /Pache Software Foundation//DID Struts Configuration 2.3//EN" 
"http://struts.apadhe.org/dtds/struts- 2.3.dtd"> 
< struts> 
< ccnstant nerer "struts .multipart mewSize" value= "10485760"> < /ccnstent> 
< package name= "default" namespace= "/" extends= "struts- default"> 
< action namer "upload" class— "ewanple.action.FileUploadAction"> 
< result> /sucoess.jsp< /result> 


上 述 配 置 将 Struts 2 允许 上 传 的 最 大 文件 长 度 和 Action 允许 处 理 的 最 大 长 度 设置 
为 10MB, 并 且 只 允许 上 传 扩 展 名 为 .jpg、 gif 和 . rar 的 文件 。 


814 上 传 多 个 文件 


如 果 一 次 希望 上 传 多 个 文件 ,需要 在 form 表单 中 使 用 多 个 name 相同 的 file 标签 
(或 者 HTML 中 的 二 input type 二 "file” ... /全 ) ,例如 : 
< 3:fom action= "upload2" enctype= "multipart/form- data"> 
<s:file name= "file" label= 只 件 >< /s:file> 
< s:file name= "file" label= "附件 必 < /s:file> 
< 3:file name= "file" label= 只 件 >< /s:file> 
<s:submit value= "提交 "> 
</s:fom> 


在 接收 文件 上 传 处 理 的 Action 类 中 ,可 以 使 用 数组 或 List 接收 上 传 文件 的 信息 。 
当 使 用 数组 接收 时 ,Action 类 中 需要 提供 以 下 三 个 属性 及 其 get 和 set 方法 。 

Private File[] file; 

Private String[] fileFileName; 

private String[] filecontentTypey 

当 使 用 List 接收 时 ,Action 类 中 需要 提供 以 下 三 个 属性 及 其 get 和 set 方法 。 

Private List< File> file; 

private List< String> fileFileName; 

private List< String> fileContentType; 

代码 8-4 给 出 了 一 个 用 于 处 理 上 述 表 单 上 传 多 文件 的 Action 类 ,该 类 利用 List 接收 
上 传 文件 的 信息 。 
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代码 8-4 用 List 实现 多 文件 上 传 


import java.io.* ; 

import java.util .List; 

import javax.servlet..ServletContext; 

import om. opensynrphony.xwork?.ActionSupport; 


Public class FileUploadAction? extends ActionSupport { 


private List< File> file; // 代 表 上 传 文件 的 file 对 象 列表 
private List< String> fileFileNamey // 上 传 文件 的 文件 名 列表 
private List< String> fileContentType; // 上 传 文件 的 内 容 类 型 列表 


/人 /省略 了 gat 和 set 方 法 


Public String execute () throws Exosption { 
ServletContext context= ServletActionContext .getServletContext (); 


String dir= oontext .getRealPath ("/WEB- INF™); // 著 取 /WEB- mE 的 真实 路 径 
BufferedputputStream bos= null7 
BufferedInputStream bis=null; 
for (int i=0; i<file.size(); 计 +) { // 逐 个 处 理 Iist 中 的 每 个 文件 
try{ 
FileInputStream fis= new FileInputStream(file.get (i)); 
bis= new BufferedInputStream(fis); // 定 义 输入 流 


RileOutputStream fos= new FileOutputStream(new File (dir, 
fileFileName.get (i))); 
bos= new Bufferedoutput Stream(fos); /定义 输出 流 
byte[] buf= new byte[4096]; // 定 义 读 写 缓冲 区 
int len= 一 17 
while ((len=bis.read(buf)) !=-1) { // 读 文件 
bos.write (ouf, 0, len); // 写 文件 
} 
} finally { 
try { 
证 ul (=bis) 
bis.close(); // 关 闭 输 入 流 
} catch (IOExcepticn e) { 
e.printStackTrace (); 
} 
try{ 
证 (null (=bos) 
bos.close(); // 关 闭 输 出 流 
} catch (IOExcepticn e) { 
e.printStackTrace (); 


Ietum SUOCESS; 
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. 
¥ 


利用 数组 接收 多 文件 的 方法 与 上 述 代码 大 同 小 异 ,读者 可 以 自行 练习 一 下 。 


82 文件 的 下 载 


821 文件 下 载 概述 


在 研究 了 文件 的 上 传 之 后 ,下 面 介绍 文件 的 下 载 。 有 的 读者 可 能 会 想 , 只 要 为 每 个 
文件 提供 一 个 链接 ,不 就 可 以 下 载 了 吗 ? 这 种 方法 的 确 能 够 实现 文件 的 下 载 ,但 是 会 引 
发 几 个 问题 。 

(1) 由 于 暴露 了 文件 的 真实 地 址 ,一 些 没有 获得 授权 的 用 户 也 能 够 下 载 该 文件 。 

(2) 对 于 一 些 珍 贵 的 .独家 提供 下 载 的 资源 ,无 法 防止 其 他 网 站 跨 站 点 引用 它们 。 

(3) 服务 器 端 文件 只 能 存放 在 Web 应 用 程序 所 在 的 目录 下 (WEB-INF 子 目录 除外 ) 。 

事实 上 ,有 时 为 了 保护 文件 不 被 非法 下 载 或 链接 ,可 能 会 把 它们 存放 在 WEB-INF 子 
目录 下 、Web 应 用 程序 安装 目录 以 外 的 位 置 或 是 数据 库 中 ,此 时 不 能 通过 一 个 静态 的 超 
级 链接 提供 下 载 , 必 须 通 过 编程 的 形式 动态 生成 下 载 地 址 。 


822 gream 结 果 类 型 


Struts 2 专门 提供 了 一 种 stream 结果 类 型 来 支持 文件 下 载 。stream 结果 类 型 具有 
7 个 可 选 参数 ,如 表 8-1 所 示 。 
表 8-1 stream 结果 类 型 的 参数 


参数 名 称 默认 值 说 明 
contentType text/plain 下 载 文 件 的 内 容 类 型 
contentLength 下 载 文 件 的 长 度 , 供 浏览 器 显示 进度 条 
contentDisposition | inline 指定 文件 下 载 的 默认 名 字 。 如 果 不 指定 , 则 使 用 Action 名 . action 
pts bn Action 中 用 于 返回 InputStream 的 get 方法 的 名 字 , 类 型 为 
InputStream 
bufferSize 1KB 文件 读 写 缓冲 区 的 大 小 ,以 字 节 为 单位 
allowCaching true 是 否 允 许 浏览 器 缓存 
contentCharSet HTTP 响应 头 信 息 中 的 编码 方式 


参数 contentDisposition 的 可 选 值 包括 以 下 两 个 。 

(1) inline;filename 一 "下 载 文 件 名 ": inline 表示 在 浏览 器 中 打开 该 文件 。inline 可 
以 省 略 。 

(2) attachment; filename 二 "下 载 文 件 名 ": attachment 表示 弹出 “文件 下 载 ” 对 
话 框 。 

当然 ,如 果 浏 览 器 不 支持 该 文件 类 型 的 显示 ,无 论 指定 的 是 inline 还 是 attachment， 
都 会 弹出 “文件 下 载 ” 对 话 框 。 
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下 面 给 出 一 个 stream 结果 类 型 的 例子 。 


< result type= "stream"> 
< param name= "ontent Type"> image/jpeg< /param> 
< param name= "inputName"> imageStreanK /param> 
< param name= "oontentDisposition"> attadment;filename= "photo.jpg"< /paran> 
< param name= "bufferSize"> 1024< /param> 
< /result> 


823 文件 下 载 实 例 
下 面 给 出 一 个 文件 下 载 的 例子 。 


1 编写 文件 下 载 页 面 
编写 文件 下 载 页 面 , 如 代码 8-5 所 示 。 


代码 8-5 文件 下 载 页 面 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 
<html> 
<head> 
<title> 下 载 文件 < /title> 
< /head> 
<body> 
<a href= "download.action"> 下 载 文件 < /a> 
< /body> 
< /himl> 


2 编写 处 理 文件 下 载 的 Adian 类 
新 建 一 个 FileDownloadAction 类 ,用 于 处 理 文件 下 载 ,如 代码 8-6 所 示 。 


代码 8-6 FileDownloadAction. java 


Package examrple.acticny 


jimport java.io.#* 7 
jimport om.opensyrphony .xwork2.ActionSupport; 


miblic class FileDownloadacticn extends ActionSupport { 


// 创 建 inputstream, 为 stream 流 的 InputName 参 数 提供 值 
Public InputStream getInputStream() throws Exoeption { 


File file= new File("d:\photo\IMS 2527.jpg"); 
retum new FileInputStream(file); 
3 


pblic String execute () throws Exception { 
Teturn SUOCESS; 
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} 


/| 提供 转换 编码 后 的 供 下 载 用 的 文件 名 
Eublic String getDomnloadFileName() { 
String downFileName= "照片 .jpg"; // 下 载 到 客户 端的 文件 名 


try { 
// 解 决 中 文 文件 名 乱码 问题 
GownFi leName= new String (downFileName.getBytes () ，"TSO8858- 1"); 
} catch (UnsupportedEnoodingException e) { 
e.printStackTrace (); 
} 
retumn downFileNamey 


FileDownloadAction 类 提供 了 为 stream 的 InputName 参数 的 默认 值 inputStream 
提供 了 get 方 法 。 


3 配置 FleDowmnlcadAction 
编辑 struts. xml, 并 配置 FileDownloadAction ,如 代码 8-7 所 示 。 


代码 8-7 在 struts. xml 中 配置 FileDownloadAction 


< param name= "bufferSize"> 4096< /paran> 
< /result> 
< /action> 


上 述 代 码 中 的 $ {downloadFileName} 将 调用 FileDownloadAction 的 getDownloadFileName 
方法 获取 保存 到 客户 端的 文件 名 。 

在 本 例子 中 , 待 下 载 的 文件 名 被 硬 编码 在 FileDownloadAction 类 中 。 在 实际 的 应 用 
中 ,肯定 不 会 采用 这 种 方法 。 在 本 章 的 案例 部 分 ,将 研究 任意 文件 的 下 载 。 

在 调试 文件 下 载 Action 时 ,经 常会 看 到 下 面 的 错误 信息 。 

Can not find a java. io. InputStream with the name [inputStream] in the invocaticn stack. Check the < 

Param name= "inputName"> tag specified for this action. 

产生 这 种 错误 的 原因 是 因为 InputStream 没有 创建 成 功 , 取 值 为 null。 读 者 可 以 向 
控制 台 输 出 待 下 载 文 件 的 真实 路 径 ,看 是 否 存在 错误 。 


83 案例 5: 为 留言 板 程序 添加 附件 功能 


831 为 留言 板 添加 上 传 附 件 功能 
如 果 希 望 用 户 在 留言 时 可 以 上 传 附件 ,需要 为 留言 板 添 加 文件 上 传 功能 。 
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1 修改 留言 页 面 postjsp 
修改 留言 页 面 post. jsp, 增 加 file 标签 ,如 代码 8-8 所 示 (为 节约 篇 幅 , 仅 给 出 表单 


2 


内 容 ) 。 


代码 8-8 添加 了 file 标签 的 留言 页 面 


< s:form action= "addNote.action" theme= "simplen" 
enctyper "multipart/fom- data" method= "post"> 
<div class= "coll" style= "text- align: right"> 标 题 < /div> 
<div class= "co12"> 
< s:textfield name= "note.title" size= "50"> < /s:textfield> 
< /div> 
< div class= "clear"> < /div> 
<div class= "coll" styler "text- align: right"> 内 容 < /div> 
<div class= "co012"> 
< 5:textarea rows= "20" cols= "60" name= "note.content"> 
< /s:textarea> ( 少 于 1000 字 ) 
</div> 
<div class= "clear"> < /div> 
< div class= "coll" style= "text- align: right"> 附 件 < /div> 
<div class= "col2"> 
< s:file neme= "attachment"> < /s:file> 
</div> 
<div class= "col2"> 
<s:submit value= "确定 ">< /s:submit> 
<s:reset value=" 重 填 ">< /s:reset> 
</div> 
< /s:fomr> 


由 于 form 标签 使 用 了 simple 主题 ,因此 必须 显 式 地 将 method 属性 设置 为 post。 


2 修改 处 理 留 言 的 Acion 类 
修改 处 理 留言 的 NotesAction 类 ,为 该 类 添加 接收 上 传 文件 信息 的 三 个 属性 ,并 编写 
文件 上 传代 码 ,如 代码 8-9 所 示 。 


代码 8-9 NotesAction. java 


Package notes.action; 


inport java.io.* 7 

import javautil.x ; 

import notes.dao.NotesDao; 

import notes.dao.impl.NotesDaoTmpl; 
import notes.model. * ; 

jimport om.cpensymphony .xwork2. * ; 


Public class NotesAction extends ActionSupport { 
private Notes note; 
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private List< Notes> notes- new ArrayList< Notes> (); 


private String uploadDir; 1/ 上传 文件 的 相对 路 径 , 从 struts.xml 中 获得 
private File attadment; // 代 表 上 传 文件 的 file 对 象 
private String attachmentFileNamey // 上 传 文件 的 文件 名 

private String attadmentContentType; // 上 传 文件 的 内 容 类 型 


// 省 略 了 ge 和 sat 方法 


Public String list() { // 列 出 所 有 的 留言 
NotesDao notesDao= new NotesDacTmpl (); 
notes= notesDao.getAllNotes (); 
return SUOCESS; 

} 


Public String ada() { // 添 加 新 留言 
if (null==note) 
Tetum INFUT; 


ActionContext context= ActionContext .getContext (); 
Map session= oontext .getSessicn(); 
User user= (User) session.get ("user"); 
if (mull==user) 
retum IOGIN; 


if (rlll= attachment) // 如 果 当 前 的 留言 有 附件 ,上 传 
wpload(); 


note.setUser (user); 

NotesDao notesDao= new NotesDacImpl (); 
notesDao.adcNote (note) ; 

retum SUOCESS; 


Public String detail() { // 取 得 某 个 留言 的 详细 信息 
NotesDao notesDao= new NotesDaoImpl (); 
note= notesDao.getNoteById (noteId) ; 
retum SUOCESS; 
} 
/* 完成 文件 上 传 操作 * / 
Private void upload (){ 
// 获 得 存储 附件 的 目录 的 真实 路 径 
String path= ServletActionContext .getServletContext () 
.getRealPath (uploadDir) ; 
File dir=new File (path); 
// 存 放 附件 的 目录 如 果 不 存 在 , 则 创建 
if(!dir.exists()) 
dir.mkdir(); 


/* 得 到 当前 时 间 自 1970 年 1 月 1 日 0 时 0 分 0 秒 开始 流逝 的 毫秒 数 , 用 其 作为 新 文件 的 
文件 名 * / 
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String newFileName; 
long now= new Date () .getTime (); 
int indese=- attadmentFi leName. lastIndexOf ('.'); 
/ 淹 断 文件 是 否 有 扩展 名 
if(index!=-1) 
newFi leName—= nowt this.attadmentFileName. substring (index); 
else 
newFi leName= Long.toString (now) ; 


byte[] buf= new byte[4096]; 
BufferedInputStream bis=null; 
BufferedputputStream bos=null; 


// 读 取保 存在 临时 目录 下 的 上 传 文件 , 写 人 新 文件 
try{ 
FileInputStream fis= new FileInputStream(attadment); 
bis= new BufferedInputStream(fis); 
FileOutputStream fos= new FileOutputStream( 
new File (dir, newFi leName)); 
bos= new BufferedoutputStream(fos); 


int len= 一 17 
while( (len=bis.read (buf))!=-1) 
bos.write (buf,0, len); 


/在 留言 内 容 后 面 添加 一 条 下 载 附件 的 链接 
String content= note.getContent (); 

content+= "< /br> "; 

contentt="<a href— ""; 

content+ = "download.action?fileName= "+ newEi leName; 
content+= "> 附件 < /a> "; 


Dote.setContent (omtent); 
note.setAttacment (newFileName) 7 
j}catch (ICExcepticn e){ 
e.PrintStackTrace () 7 
finally{ 


try{ 
if(null!=bis) 
bis.close(); 


if(null!=bos) 
bos.close(); 

jcatch (IoException e) { 
e.printstackTrace(); 
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} 
¥ 


NotesAction 类 在 上 传 文件 时 ,构造 了 一 个 利用 download. action 下 载 附件 的 超级 链 
接 ,并 将 其 附加 在 留言 内 容 的 末尾 ,用 户 可 以 通过 点 击 该 超级 链接 下 载 附 件 。 另 外 ,在 上 
传 文件 时 ,为 了 解决 文件 重 名 问题 ,利用 自 1970 年 1 月 1 日 0 时 0 分 0 秒 开始 流逝 的 毫 
秒 数 作 为 新 文件 的 文件 名 。 

属性 uploadDir 存放 上 传 文件 的 目录 名 ,可 以 在 struts. xml 中 配置 NotesAction 时 
指定 ,以 利于 系统 维护 。 关 于 NotesAction 类 在 struts. xml 中 的 配置 ,将 在 解决 完 文件 
下 载 之 后 一 起 讲解 。 


832 为 留言 板 添加 下 载 附件 功能 

1 文件 下 载 Acio 类 

在 上 传 文件 时 ,下 载 附件 的 超级 链接 已 经 添加 在 留言 内 容 的 末尾 , 形 如 : 
comnload.action?fileNeme— 1344844497781.jpg 


在 编写 处 理 下 载 文件 的 Action 类 时 ,只 需 通 过 fileName 属性 获取 下 载 的 文件 名 , 然 
后 构造 一 个 InputStream 对 象 就 可 以 了 ,如 代码 8-10 所 示 。 


代码 8-10 文件 下 载 类 


Peckage notes.action; 

dmport java.io.* ; 

import javax.servlet.ServletContext; 

import org.apache.struts?2.ServletActionContext; 

jmport om.cpensyrphony .xwork?2.ActionSupport; 

Public class FileDcwmnlcadncticn extends ActionSupport { 
Private String fileName; // 初 始 的 通过 param 指 定 的 文件 名 属性 
Private String domnloadDir; // 下 载 文件 所 在 的 目录 


Public void setFileName (String fileName) { 
this.fileName= fileName; 

Public void setDownloadDir (String downloadDir) { 
this.downloadDir= downloadDir; 

} 


Public InputStream getInputStream() throws Exosption { 
// 通 过 servletcontext, 也 就 是 aeplicaticn 来 读 取 数据 
ServletContext oontext= ServletActionContext .getServletContext () 7 
String pathr oontext .getRealPath (downloadDir) ; 


String downloadFile= patht \\"+ fileName; 
// 构 造 关于 下 载 文件 的 Inputstream 对 象 
File file=new File (GownloadFile); 

retum new FileInputStream(file); 
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Public string execute() throws Exosption { 
retum SUOCESS; 


和 
提供 转换 编码 后 的 供 下 载 用 的 文件 名 */ 
Public String getDownloadFileName () { 
String downFileName— fileName; 
try{ 
downFi leName— new String (downFileName .getBytes (), "TS08858- 1"); 
} catch (UnsupportedEnoodingExosption e) { 
e.printStackTraoce (); 
} 
retum downFileName; 


2 修改 srusxnm 


修改 留言 板 程序 的 struts. xml, 添加 FileDownloadAction 的 配置 ,并 重新 配置 
NotesAction 类 ,如 代码 8-11 所 示 。 


代码 8-11 struts. xml 


< package name= "default" namespace= "/" extends= "struts- default"> 


< action name= "addNote" class= "notes.action.NotesAction" 
method= "add"> 
< result type= "redirectAction"> listNotes< /result> 
< result name= "input"> WEB- INF/jsp/post.jsp< /result> 
< parem name= "uploadDir"> uploadFi les< /paran> 
< interceptor- ref name= "auth"> < /interceptor- ref> 

< /action> 


在 配置 NotesAction 的 addNotes 方法 时 ,通过 一 个 静态 参数 为 NotesAction 实例 的 
uploadDir 属性 赋值 ,用 于 设置 上 传 文件 的 路 径 。 注 意 ,由 代码 8-9 可 知 , 上 传 文件 只 能 存 
放 在 Web 应 用 程序 部 署 目录 的 某 个 子 目录 中 。 另 外 ,在 配置 FileDownloadAction 时 , 通 
过 一 个 静态 参数 为 该 类 实例 的 downloadDir 属性 赋值 ,其 值 应 该 和 uploadDir 属性 的 值 
一 致 。 
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同步 训练 


为 站 内 短信 系统 添加 附件 上 传 和 下 载 功 能 。 

方法 1: 附件 下 载 链接 可 以 附着 在 短信 内 容 之 后 。 

方法 2: 将 附件 的 地 址 单独 存放 在 数据 表 的 一 个 字段 中 ,在 下 载 页 面 提供 一 个 单独 
的 下 载 链接 。 
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91 输入 验证 概述 


一 个 Web 应 用 程序 必须 保证 用 户 输入 的 数据 是 有 效 的 。 例 如 ,在 一 个 注册 程序 中 ， 
用 户 名 是 否 填 写 ,输入 的 口令 长 度 是 否 合法 ,两 次 口令 是 否 一 致 ,输入 的 E-mail 地 址 是 否 
满足 格式 要 求 等 。 一 个 健壮 的 应 用 程序 不 会 因为 用 户 输入 的 数据 不 合法 而 显示 一 大 堆 
错误 信息 ,也 不 会 因为 恶意 用 户 输入 的 伪造 数据 而 导致 系统 信息 泄露 。 

在 Web 应 用 程序 开发 中 ,常用 的 数据 验证 技术 包括 客户 端 验证 和 服务 器 验证 两 种 。 
客户 端 验证 主要 是 通过 JavaScript 脚本 实现 的 ,验证 速度 快 , 若 有 不 符合 要 求 的 输入 , 响 
应 信息 能 够 快速 地 返回 给 用 户 。 由 于 验证 数据 不 需要 提交 给 服务 器 ,客户 端 验证 不 会 加 
重 服务 器 的 负载 。 但 是 ,客户 端 验 证 存在 一 个 致命 缺点 。 目 前 ,很 多 工具 可 以 在 输入 数 
据 经 过 客户 端 验证 后 ,浏览 器 发 送 请 求 前 ,截取 数据 ,恶意 用 户 可 以 修改 请 求 中 的 数据 ， 
将 恶意 数据 注 和 服务器。 服务 器 端的 验证 可 以 弥补 客户 端 验证 的 不 足 , 它 除了 能 够 实现 
客户 端 验 证 提供 的 功能 外 ,还 能 够 实现 数据 逻辑 的 验证 ,例如 验证 码 是 否 正确 等 。 

Struts 2 提供 了 一 套 验 证 框架 ,能 够 完成 输入 数据 的 常规 验证 工作 。 使 用 验证 框架 ， 
程序 员 只 要 在 一 个 格式 为 XML 的 验证 文件 中 声明 输入 数据 应 该 满足 的 规则 ,例如 哪些 
字段 需要 验证 ,应 该 满足 什么 验证 条 件 , 当 验证 失败 时 应 该 把 什么 样 的 出 错 消息 发 送 到 
客户 端 ,等 等 。 

Struts 2 验证 框架 中 内 置 了 很 多 验证 器 ,每 个 验证 器 对 应 一 个 Java 类 。 当 用 户 提 交 
输入 数据 时 ,Validator 拦截 器 负责 调用 验证 器 验证 输入 数据 是 否 满足 规则 。Validator 
拦截 器 已 经 包含 在 defaultStack 拦截 器 栈 中 ,只 要 在 配置 struts. xml 时 确保 Action 类 引 
用 了 defaultStack ,就 无 须 手 工 引用 Validator 拦截 器 了 。 

利用 Struts 验证 器 进行 输入 验证 的 步骤 如 下 。 

(1) 确定 需要 验证 的 Action 类 。 

(2) 为 每 个 待 验证 的 Action 类 编写 验证 配置 文件 。 验 证 配置 文件 应 该 和 Action 类 
放 在 同一 个 Java 包 中 ,文件 名 应 该 是 以 下 两 种 格式 中 的 一 种 。 

ClassName_ validaticn xml 

ClassName alias- validaticn xml 

其 中 ,ClassName 表示 待 验证 的 Action 类 的 名 字 ;alias 表示 在 struts. xml 中 配置 的 
Action 的 名 字 。 
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当 Action 类 只 有 一 个 动作 ,或 者 虽然 有 多 个 动作 ,但 是 这 些 动作 的 验证 规则 一 致 时 ， 
可 以 使 用 第 一 种 格式 为 验证 配置 文件 命名 。 如 果 一 个 Action 类 中 的 不 同 动作 的 验证 规 
则 不 一 致 ,必须 为 每 个 动作 分 别 编写 验证 配置 文件 ,这 时 候 采用 第 二 种 格式 。 当 一 个 
Action 类 同时 具有 以 上 两 种 格式 的 验证 配置 文件 时 ,例如 RegisterAction-validation. xml 
和 RegisterAction-reg-validation. xml, 当 用 户 访问 /reg. action 时 ,验证 框架 将 首先 加 载 
RegisterAction-validation. xml, 然后 加 载 RegisterAction-reg-validation. xml, 并 且 两 个 
验证 配置 文件 的 验证 规则 是 释 加 的 ,而 不 是 覆盖 的 。 
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http://www. opensymphony. com/xwork/xwork-validator-1. 0. 3. dtd 定义 了 验证 
配置 文件 的 结构 ,这 个 文件 在 xwork-core-x. x. x. jar 中 也 可 以 找到 。 

xwork-validator-1. 0. 3. dtd 定义 了 两 种 类 型 的 验证 器 。 

(1) 字段 验证 器 (Field Validator) : 字段 验证 器 与 表单 中 的 某 个 输入 标签 相关 联 , 在 
将 输入 标签 的 值 赋 给 一 个 Action 动作 的 属性 之 前 会 发 生 验 证 行为 。Struts 2 内 置 的 验 
证 器 基本 上 都 是 字段 验证 器 。 

(2) 普通 验证 器 (Non-Field Validator): 普通 验证 器 不 和 表单 中 某 个 特定 的 输入 标 
签 相 关联 ,它们 主要 用 来 测试 几 个 输入 标签 之 间 是 否 满足 某 种 特定 的 条 件 。 

字段 验证 器 在 验证 失败 后 ,会 将 错误 消息 放 到 Action 类 字段 错误 消息 中 ,可 以 在 页 面 
中 利用 Struts 的 fielderror 标签 显示 错误 信息 。 普 通 验证 器 在 验证 失败 后 ,会 将 消息 放 到 
Action 级 别 的 错误 消息 中 ,可 以 在 页 面 中 利用 Struts 的 actionerror 标签 显示 错误 信息 。 

代码 9-1 给 出 了 xwork-validator-1. 0. 3. dtd 的 内 容 。 


代码 9-1 xwork-validator-1.0.3. dtd 


< ?ml versicn= "1 .0" enooding= "UIF- 8"?> 
< 二 = 
XWork Validators DID. 
Used the following DOCTYEE . 
< !DOCTYEFR validators EUBLIC 
™ [apache Struts//xWork Validator 1.0.3//EN" 
"http://struts.apache.org/dtds/xwork— validator- 1.0.3.dtd"> 
5 到 
< !ELEMENT validators (field|validator)+> 
< !ELEMENT field (field- validator+ )> 
< IATTLIST field 
name COATA # REQUIFED 
EE 
< !ETEMENT field- validator (param* , message)> 
< IATTLIST field- validator 
type COATA # RECUIRED 
short- circuit (true|false) "false" 
> 
< IETEMENT validator (raram* , message)> 
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< IATILIST validator 

type COATA # REQUIRED 

short— circuit (true| false) "false" 

> 
< IELEMENT param (# PCDATIA)> 
< IATTLIST param 

name COATA # FECUIRED 
> 
< !IETEMENT message (# PCDATA|param) * > 
< IATTLIST message 

key CDRTR # IMPLIED 
> 


从 DTD 文件 中 可 以 看 到 验证 配置 文件 的 DOCTYPE 和 包含 的 各 个 元 素 。 下 面 简单 
介绍 各 个 元 素 的 用 法 。 

(1) validators 元 素 : validators 是 验证 配置 文件 的 根 元 素 , 它 可 以 有 任意 个 数 的 
field 和 validator 子 元 素 。 

(2) field 元 素 : 每 个 field 元 素 对 应 Action 类 的 一 个 属性 ,该 属性 的 值 需要 被 一 个 或 
多 个 字段 验证 器 验证 。field 元 素 有 一 个 必需 的 属性 name, 必 须 和 表单 标签 的 name 属性 
取 值 一 致 。 在 field 元 素 中 应 该 包含 一 个 以 上 field-validator 子 元 素 , 用 于 指明 要 使 用 的 
验证 器 的 类 型 。 

(3) field-validator 元 素 : 用 于 配置 对 Action 属性 的 验证 规则 。 它 包含 一 个 必需 的 
属性 type, 用 于 指定 要 使 用 的 验证 器 的 类 型 。field-validator 元 素 还 包含 一 个 可 选 的 属性 
short-ciruit, 用 于 指示 在 本 验证 器 失败 时 是 否 阻 止 其 他 验证 器 的 执行 ,默认 值 为 false。 
field-validator 元 素 的 内 部 必须 包含 一 个 message 子 元 素 , 还 可 以 包括 0 个 或 多 个 param 
子 元 素 。 

(4) message 元 素 : 用 于 指定 验证 失败 时 的 错误 消息 , 它 有 一 个 可 选 属 性 key, 用 于 
读 取 国 际 化 资源 文件 中 的 本 地 消息 。 

(5) param 元 素 : 用 于 向 验证 器 传递 参数 值 。 它 包含 一 个 必需 的 name 属性 ,用 于 指 
示 参 数 的 名 称 。 

(6) validator 元 素 : 用 于 声明 字段 验证 器 或 者 普通 验证 器 。 它 包含 一 个 必需 的 属性 
type, 用 于 指定 要 使 用 的 验证 器 的 类 型 。 与 field 元 素 一 样 , validator 元 素 也 包含 一 个 可 
选 的 属性 shortrciruit, 用 于 指示 在 本 验证 器 失败 时 是 否 阻 止 其 他 验证 器 的 执行 ,默认 值 
为 false。field-validator 元 素 也 必须 包含 一 个 message 子 元 素 . 还 可 以 包括 0 个 或 多 个 
param 子 元 素 。 如 果 使 用 validator 元 素 声 明 一 个 字段 验证 器 ,必须 定义 一 个 名 为 
fieldName 的 参数 来 指示 所 要 验证 的 表单 标签 。 


93 Struts 2 内 置 的 验证 器 


xwork-core-2. 3. 4.jar 提供 了 16 种 内 置 的 验证 器 ,包括 required 验证 器 requiredstring 
验证 器 ,int 验证 器 、long 验证 器 、short 验证 器 double 验证 器 、date 验证 器 、expression 
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验证 器 .fieldexpression 验证 器 、email 验证 器 、url 验证 器 visitor 验证 器 .conversion 验 
证 器 .stringlength 验证 器 .regex 验证 器 和 conditionalvisitor 验证 器 等 。 


931 required 验证 器 
required 验证 器 用 于 检查 指定 的 Action 属性 的 值 是 否 不 为 null。 表 9-1 给 出 了 
required 验证 器 的 参数 。 
表 9-1 required 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 


指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验 证 时 ， 
需要 提供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


fieldname String 


代码 9-2 所 示 为 required 验证 器 的 一 个 示例 。 
代码 9-2 ”required 验证 器 示例 


<validators> 
< 上 -validator 声 明 required 验 证 器 ,属性 type 指 示 了 验证 器 的 类 型 ,参数 fieldName 指示 了 所 
要 验证 的 Actin 属 性 ,于 元 素 message 给 出 了 验证 失败 时 的 错误 信息 一 > 
< validator type= "required"> 
< param name= "fieldNamen> title< /param> 
<message> 留言 主题 不 能 为 空 值 < /message> 
< /validator> 


<!--field 声 明 required 验证 器 ,属性 name 指示 了 所 要 验证 的 acticn 属性 , 子 元 素 field- 
validator 的 属性 type 指 示 了 验证 器 的 类 型 , 子 元 素 message 给 出 了 验证 失败 时 的 错误 信息 - 
-> 
< field name= "title"> 

< field- validator type= "required"> 

<message> 留言 主题 不 能 为 空 值 < /message> 

< /field- validator> 

< /field> 
< /validators> 


932 requiredstring 验 证 器 


requiredstring 验证 器 用 于 检查 指定 的 Action 属性 值 不 为 null ,并 且 长 度 应 该 大 于 0 
(也 就 是 Action 属性 值 不 能 为 "")。requiredstring 验证 器 的 参数 如 表 9-2 所 示 。 


表 9-2 requiredstring 验证 器 的 参数 


参数 名 称 | 数据 类 型 说 明 


i Si 指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 提供 
ee "ng | 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


trim Boolean “| 在 验证 前 是 否 要 删除 属性 首尾 的 空格 ,默认 值 为 true 


代码 9-3 所 示 为 requiredstring 验证 器 的 一 个 示例 。 
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代码 9-3 requiredstring 验证 器 示例 


<validators> 
< 上 -validator 声 明 requiredstring 验 证 器 。 参 数 trim 的 默认 值 为 tre, 可 以 省 略 。 一 > 
<validator type= "requiredstring"> 
< param name= "fielAName"> title< /param> 
< param name= "trim"> true< /param> 
<message> 留言 主题 不 能 为 空 值 < /message> 
< /validator> 


< !--field 声 明 requiredstring 验 证 器 。 参 数 trim 的 默认 值 为 true, 可 以 省 略 。 一 > 
< field name= "title"> 
< field- validator type= "requiredstring"> 
< param name= "trim"> true< /parar> 
<message> 留言 主题 不 能 为 空 值 < /message> 
< /field- validator> 
< /field> 
< /Walidators> 


933 intong 和 shat 验证 器 


int 验证 器 .long 验证 器 和 short 验证 器 分 别 用 于 检查 指定 的 Int 型 整数 .Long 型 整 
数 和 Short 型 整数 是 否 在 某 个 范围 内 。 三 个 验证 器 具有 相同 的 参数 ,如 表 9-3 所 示 。 


表 9-3 int 验证 器 .long 验证 器 和 short 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 


指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 
提供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


max Int/Long/Short | 最 大 值 。 如 果 没 有 指定 该 参数 , 则 没有 最 大 值 限 制 
min Int/Long/Short | 最 小 值 。 如 果 没有 指定 该 参数 , 则 没有 最 小 值 限 制 


fieldname String 


代码 9-4 所 示 为 int 验证 器 的 一 个 示例 。long 验证 器 和 short 验证 器 的 用 法 与 int 型 
一 致 ,不 再 额外 举例 。 
代码 9-4 ”int 验证 器 示例 


<validators> 
< 上 -validator 声 明 int 验证 器 。 参 数 min 指 示 age 的 最 小 值 为 18, 参 数 mex 指示 age 的 最 大 值 
为 45--> 

< validator type= "int"> 
< param name= "fielAName"> age< /param> 
< param name= "min"> 18< /param> 
< param name= "max"> 45< /param> 
<message> 年 龄 必须 在 $fmin} 和 $fmex} 之 间 < /message> 

< alidator> 


< !--field 声 明 int 验证 器 。 参 数 min 指 示 age 的 最 小 值 为 18, 参 数 max 指 示 age 的 最 大 值 为 45 


-> 
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< field name= "age 
< field validator type- "int"> 
< param name= "min"> 18< /parar> 
< param name= "max"> 45< /parar> 
<message> 年 龄 必须 在 $fmin} 和 $fmex) 之 间 < /message> 
< /field- validator> 
</field> 
< /validators> 


上 述 代 码 的 message 元 素 中 出 现 了 两 个 OGNL 表达 式 $ {min} 和 $ {max)。 
$ {min}) 表 示 取 参数 min 的 值 , $ {max}) 表 示 取 参数 max 的 值 。 


934 double 验证 器 


double 验证 器 用 于 检查 指定 的 双 精 度 浮 点 数 是 否 在 某 个 范围 内 。double 验证 器 的 
参数 如 表 9-4 所 示 。 


表 9-4 ”double 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 
fieldname String | 指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 
提供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 
Double。 | 指定 双 精 度 浮 点 数 的 最 小 值 , 待 验证 的 值 可 以 等 于 该 值 。 如 果 没 有 
指定 该 参数 , 则 没有 最 小 值 限制 
de Double | 指定 双 精 度 浮 点 数 的 最 大 值 , 待 验证 的 值 可 以 等 于 该 值 。 如 果 没 有 
指定 该 参数 , 则 没有 最 大 值 限制 
minExclusive pouble。 | 指定 双 精 度 浮 点 数 的 最 小 值 , 待 验证 的 值 必须 大 于 该 值 。 如 果 没 有 
指定 该 参数 , 则 没有 最 小 值 限制 
maxExclusive | Double | 指定 双 精度 浮 点 数 的 最 大 值 , 待 验证 的 值 必须 小 于 该 值 。 如 果 没 有 
指定 该 参数 , 则 没有 最 大 值 限制 


代码 9-5 所 示 为 double 验证 器 的 一 个 示例 。 
代码 9-5 double 验证 器 示例 


<validators> 
< 上 -validator 声 明 double 验证 器 一 > 
< validator type= "double"> 
< param name= "fieldName"> salary< /parar> 
< param name= "minInclusive"> 1000.0< /parar> 
< param name= "maxInclusive"> 9999.99< /paran> 
<message> 
工资 必须 大 于 等 于 $fminInclusive} 并 且 小 于 等 于 $fmaxInclusive} 


< !--field 声 明 double 验 证 器 一 > 
< field name= "peroentage"> 
< field- validator type= "double"> 
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< param name= "minExclusive"> 999.9% /param> 
< param name= "maxExclusiven> 10000.0< /param> 
<message> 
工资 必须 大 于 $fminExclusive} 并 且 小 于 $ fmaxExclusive} 


935 ”date 验 证 器 


date 验证 器 用 于 检查 指定 的 日 期 型 数据 是 否 在 某 个 范围 内 。 表 9-5 给 出 了 date 验 


证 器 的 参数 。 
表 9-5 date 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 


指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验 证 时 ,需要 提 


fieldname | String 。 | 供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 
有 Double ”| 指定 日 期 的 最 小 值 。 如 果 没 有 指定 该 参数 , 则 没有 最 小 值 限制 
i Double ”| 指定 日 期 的 最 大 值 。 如 果 没 有 指定 该 参数 , 则 没有 最 大 值 限制 


代码 9-6 所 示 为 date 验证 器 的 一 个 示例 。 
代码 9-6 ”date 验证 器 示例 


< validators> 
< 上 -validator 声 明 date 验 证 器 一 > 
<validator type= "date"> 
< param name= "fieldName"> birthday< /param> 
< param name= "min"> 01/01/1990< /parar> 
< param name= "max"> 08/01/2012< /parar> 
<message> 出 生日 期 应 该 在 $fmin} 和 $fmax] 之 间 < /message> 
< /validator> 


< 上 -field 声 明 date 验证 器 --> 
< field name= "birthday"> 
< field- validator type- "date"> 
< param name= "min"> 01/01/1990< /param> 
< param name= "max"> 08/01/2012< /Parar 
<message> 出 生日 期 应 该 在 $fmin} 和 $fmaxj 之 间 < /message> 
< /field- validator> 
< /field> 
< /validators> 


936 ”eqpressian 验证 器 


expression 验证 器 用 于 检查 给 定 的 OGNL 表达 式 的 值 是 否 为 真 。 该 验证 器 是 一 个 


< 
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普通 验证 器 ,只 能 使 用 validator 元 素 验证 。 表 9-6 给 出 了 expression 验证 器 的 参数 。 
表 9-6 ”expression 验证 器 的 参数 
参数 名 称 数据 类 型 说 明 


指定 要 计算 的 OGNL 表达 式 , 该 表达 式 基于 Value Stack 求 值 。 如 
果 计 算 结 果 为 真 , 则 通过 验证 ,否则 验证 失败 


expression Boolean 


利用 expression 验证 器 验证 Value Stack 中 的 password 和 repassword 的 值 是 否 一 
致 ,如 代码 9-7 所 示 。 


代码 9-7 expression 验证 器 示例 


<!--validator 声 明 eqpressicn 验 证 器 ,验证 repassword 的 值 必须 与 password 一 致 --> 
<validators> 
< validator type= "expression"> 
< param name= "expression"> password= = repasswordk /param> 
<message> 两 次 密码 输入 不 一 致 !< /message> 
< /validator> 
< /alidators> 


937 ”figdeqpression 验证 器 


fieldexpression 验证 器 用 于 检查 给 定 的 OGNL 表达 式 的 值 是 否 为 真 。 它 的 作用 与 
expression 验证 器 类 似 ,只 不 过 fieldexpression 验证 器 既 可 以 利用 validator 元 素 验证 ,也 
可 以 使 用 field 元 素 验证 。 表 9-7 给 出 了 fieldexpression 验证 器 的 参数 。 


表 9-7 fieldexpression 验证 器 的 参数 
参数 名 称 数据 类 型 说 明 


指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 提 
供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


指定 要 计算 的 OGNL 表达 式 ,该 表达 式 基 于 Value Stack 求 值 。 如 果 
计算 结果 为 真 , 则 通过 验证 ,否则 验证 失败 


fieldname String 


expression Boolean 


代码 9-8 所 示 为 fieldexpression 验证 器 的 一 个 示例 。 


代码 9-8 ”fieldexpression 验证 器 示例 


<validators> 
< 上 -validator 声 明 fieldexpressicn 验 证 器 ,验证 repassword 的 值 必须 与 password 一 致 --> 
< validator type= "fieldexpression"> 
< param name= "fieldName"> repassword /param> 
< param name= "expression"> password= = repasswordk /parar> 
<message> 两 次 密码 输入 不 一 致 !< /message> 
< /validator> 


< 上 fisld 声 明 fisldespressicn 验 证 器 ,验证 repassword 的 值 必 须 与 passwprd 一 致 一 > 
< field name— "Tepassword"> 
< field validator typer "fieldexpressicn"> 
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< param name— "expression"> password= = repassword /param> 
<message> 两 次 密码 输入 不 一 致 < /message> 
< /field- validator> 
</field> 
< /validators> 


938 regex 验 证 器 


regex 验证 器 使 用 正则 表达 式 验证 给 定 的 字符 串 是 否 满足 某 种 格式 。 表 9-8 给 出 了 
regex 验证 器 的 参数 。 
表 9-8 regex 验证 器 的 参数 


参数 名 称 ”| 数据 类 型 说 明 

指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 提供 
该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 

指定 要 计算 的 OGNL 表达 式 , 该 表达 式 基 于 Value Stack 求 值 。 如 果 计 
算 结 果 为 真 , 则 通过 验证 ,否则 验证 失败 


fieldname String 


expression Boolean 


代码 9-9 所 示 为 regex 验证 器 的 一 个 示例 。 
代码 9-9 regex 验证 器 示例 


<validators> 
< 上 -validator 声 明正 则 验证 器 ,验证 password 属 性 --> 
< validator type= "regex"> 
< param name= "fieldName"> password< /param> 
< 上 -指定 匹配 的 正则 表达 式 一 > 
< param name= "expression"> < ! [COATA[ (\w{6,20}) ]]> < /param> 
<message> 密码 长 度 必须 在 6 到 20 之 间 , 且 必须 是 字母 或 者 数字 < /message> 
< /alidator> 


< !-- field 声明 正则 验证 器 ,验证 password 属 性 --> 
< field name= "password"> 
< field- validator type= "regex"> 
< 上 -指定 匹配 的 正则 表达 式 一 > 
< param name= "expressicn"> < ! [CDATA[ (\w{6, 20}) ]]> < /Param> 
<message> 密码 长 度 必 须 在 6 到 20 之 间 , 且 必须 是 字母 或 者 数字 < /message> 
</field- validator> 
</field> 
< /validators> 


939 email 验证 器 


email 验证 器 扩展 自 regex 验证 器 ,利用 正则 表达 式 验证 给 定 的 字符 串 是 否 是 合法 的 
E-mail 地 址 。email 验证 器 用 到 的 正则 表达 式 为 : 


\\b([' A-Za-20-9]+(\\.[' A Za-209]+)*e@ (B72a-20-9])+(\\.A- Zr-z0- 
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Ft)* ((\\.B- Zz20 9{2 DIN\.B- Zz20 9{2,N\ .BZ 20 9{2,D)$)\\b 
表 9-9 给 出 了 email 验证 器 的 参数 。 
表 9-9 email 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 
le Si 指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 提 
供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


代码 9-10 所 示 为 email 验证 器 的 一 个 示例 。 
代码 9-10 ”email 验证 器 示例 


<validators> 
< !--validator 声 明 email 验证 器 一 > 
<validator type= "email"> 
< param name= "fieldNamer> myfrail< /param> 
<message> Erail 地 址 不 合法 < /message> 
< /validator> 


< !--field 声 明 email 验证 器 --> 
< field name= "myFrail"> 
< field- validator type= "erail"> 
<message> Erail 地 址 不 合法 < /tmessage> 
< /field- validator> 
< /field> 
< Walidators> 


9310 ul 验证 器 
url 验证 器 用 于 验证 给 定 的 字符 串 是 否 是 合法 的 URL。 表 9-10 给 出 了 url 验证 器 的 参数 。 
表 9-10 url 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 
指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 
提供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


fieldname String 


代码 9-11 所 示 为 url 验证 器 的 一 个 示例 。 
代码 9-11 url 验证 器 示例 


< validators> 
< !--validator 声 明 url 验证 器 一 > 
< validator type= "orl"> 
< param name= "fieldName"> myURIK /parar> 
<message> 给 定 的 URL 不 合法 < /message> 
< /validator> 


< !-- field 声明 url 验证 器 --> 
< field name= "myURL"> 
<message> 给 定 的 UEL 不 合法 < /message> 
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</field> 
< /validators> 


9311 conersio 验证 器 
conversion 验证 器 用 于 验证 指定 的 字段 在 类 型 转换 过 程 中 是 否 发 生 错 误 。 表 9-11 
给 出 了 conversion 验证 器 的 参数 。 
表 9-11 conversion 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 


field Stri 指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验 证 时 ,需要 提 
oe "ng | 供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


代码 9-12 所 示 为 conversion 验证 器 的 一 个 示例 。 


代码 9-12 ”conversion 验证 器 示例 


<validators> 
< 上 -validator 声 明 conversicn 验 证 器 一 > 
<validator type= "oonversion"> 
< param name= "fieldName"> age< /param> 
<message> 类 型 转换 错误 ,请 输入 一 个 整数 < /message> 
< /validator> 


< !-- field 声明 conversion 验证 器 --> 
< field name= "age"> 
< field- validator type= "conversion"> 
<message> 类 型 转换 错误 ,请 输入 一 个 整数 < /message> 
< /field- validator> 
< /field> 
< /alidators> 


9312 ”stingengih 验证 器 


stringlength 验证 器 用 于 验证 指定 的 字段 在 类 型 转换 过 程 中 是 否 发 生 错 误 。 表 9-12 
给 出 了 stringlength 验证 器 的 参数 。 
表 9-12 stringlength 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 
a i 指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 
8 | 提供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 


minLength Double 指定 字符 串 的 最 小 值 。 如 果 没有 指定 该 参数 , 则 没有 最 小 值 限制 

maxLength Double 指定 字符 串 的 最 大 值 。 如 果 没有 指定 该 参数 , 则 没有 最 大 值 限制 

trim Boolean ”| 指定 在 计算 长 度 前 是 否 去 掉 字符 串 首 、 尾 的 空格 ,默认 值 为 true 
代码 9-13 所 示 为 stringlength 验证 器 的 一 个 示例 。 
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代码 9-13 stringlength 验证 器 示例 


<validators> 
< !--validator 声 明 stringlength 验 证 器 一 > 
<validator type= "stringlength"> 
< param name= "fieldName"> sno< /param> 
< param name= "ninLength"> 10< /param> 
< param name= "maxLength"> 10< /param> 
< param name= "trim"> true< /parar> 
<message> 学 号 的 长 度 应 该 是 10 个 字符 < /message> 
< /alidator> 


< !--field 声 明 stringlength 验证 器 --> 
< field namer "myPurchaseCode"> 
< field- validator typer "stringlength"> 
< param name= "fielAName"> sno< /param> 
< param name= "minLength"> 10< /param> 
< param name= "maxLengthr> 10< /param> 
< param name= "trim"> true< /parar> 
<message> 学 号 的 长 度 应 该 是 10 个 字符 < /message> 
< /field- validator> 
</field> 
< alidators> 
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有 了 时候, 多 个 Action 类 中 可 能 复合 同一 个 JavaBean 类 。 为 了 避免 在 每 一 个 Action 
类 的 验证 文件 中 都 编写 针对 该 复合 属性 的 验证 ,可 以 把 验证 信息 放 到 JavaBean 类 的 验证 
文件 中 ,然后 在 Action 类 的 验证 文件 中 直接 使 用 visitor 验证 器 去 验证 该 复合 属性 。 
表 9-13 给 出 了 visitor 验证 器 的 参数 。 
表 9-13 visitor 验证 器 的 参数 
参数 名 称 数据 类 型 说 明 
指示 所 要 验证 的 Action 属性 名 。 当 使 用 validator 元 素 验证 时 ,需要 提 


Tename | SWing | 供 该 参数 ;使 用 field 元 素 验证 时 ,不 需要 提供 该 参数 
context String 验证 发 生 的 上 下 文 

是 否 利用 message 于 元 素 为 字段 错误 提示 信息 添加 前 级 ,默认 值 
appendPrefix Boolean 为 ii 


下 面 介 绍 一 个 visitor 验证 器 的 例子 。 首 先 介绍 输入 页 面 ,如 代码 9-14 所 示 。 
代码 9-14 输入 页 面 


< $@ page language= "java" pageEnooding= "UTE- 8"%> 
< $%@ taglib uri= "/struts- tags" prefix= "s" $> 
< !DOCTYPE HIML PUBLIC ™— //W3C//DID HIML 4.01 Transitional//EN"> 
<htm> 
<head> 


<title> input< /title> 
< /head> 
<body> 
< s:fom action= "valid.action"> 
< s:radio list="# {1:'typel',2:'type?2'}" label= "type" name= "type" 
value= "1"> < /s:radio> 
< s:textfield name= "name" label= "name"> < /s:textfield> 
< s:textfield name= "bean.date" label= "date"> < /s:textfield> 
< 3:textfield name= "bean.nnber" label= "nnber"> < /s:textfield> 
< s:textfield name= "bean.nmiber2" label= "nnber?2"> < /s:textfield> 
< s:textfield name= "bean.text" label= "text"> < /s:textfield> 
<s:submit> < /s:submit> 
</s:fom> 
< /body> 
< /html> 


代码 9-15 所 示 为 演示 visitor 验证 器 的 JavaBean 类 和 Action 类 。 
代码 9-15 visitor 验证 器 示例 


/ValidatedBean.java 
Package com.cpensymphony.wsbwork.exzample7 
import java.util.Date; 
Public class ValidatedBean { 
private String text; 
Private Date date= new Date (System.currentTimeMillis())7 
private int nuber; 
private int nunber?; 
Public static final int MAX TOTRI= 12; 
// 省 略 了 get 和 set 方 法 


/NalidatedAction.java 

Package om.cpensymphony .webwork.exanple; 

jimport om.opensyrphony .xwork.ActionSupport; 

Public class Validatedacticn extends ActionSupport { 
Private ValidatedBean bean= new ValidatedBean(); 
Private String name; 

// 省 略 了 gat 和 set 方 法 


Public String execute () throws Exosption{ 
retum SUOCESS; 


上 述 代码 中 定义 了 一 个 Action 类 ValidatedAction. java, 该 类 含有 一 个 普通 属性 
name 和 一 个 类 型 为 ValidatedBean 的 复合 属性 bean。ValidatedBean 的 验证 文件 可 以 写 
成 代码 9-16 所 示 的 形式 。 
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代码 9-16 ValidatedBean-validation. xml 


<!-- 省 略 了 DOCTYEE 一 > 

<validators> 

< field name= "text"> 

< field- validator type= "requiredstring"> 
<message> Text 不 能 为 空 < /tressage> 

< /field- validator> 

< /field> 

< field naeme= "date"> 

< field validator type- "date"> 
< param name= "min"> 01/01/1970 /parar> 
<message> 日 期 不 合法 < /message> 

< /field- validator> 

< /field> 

< field naeme= "ninber"> 

< field- validator type= "int"> 
< param name= "imin"> 1< /param> 
< param name= "max"> 10< /param> 
<message> nuriber 取 值 范围 为 Stmin] 到 $fmaxj< /message> 

< /field- validator> 

< /field> 

< /validators> 


ValidatedAction 的 验证 文件 可 以 写成 代码 9-17 所 示 的 形式 。 


代码 9-17 ValidatedAction-validation. xml 


<!-- 省 略 了 DocTYEE 一 > 

<validators> 

< field name= "name"> 

< field- validator type= "required"> 
<message> name 不 能 为 空 !< /message> 

< /field- validator> 

< /field> 


< field name= "bean"> 

< field- validator type= "visitor"> 
< message> bean: < /message> 

< /field- validator> 

</field> 

< /validators> 


上 述 代码 利用 visitor 验证 器 直接 调用 ValidatedBean 的 验证 文件 对 ValidatedAction 中 
的 复合 属性 bean 进行 验证 。 如 果 bean 未 通过 验证 ,例如 number 的 值 输入 为 15 时 ,用 
户 看 到 的 错误 提示 将 是 “bean: 取 值 范围 为 1 到 10”。 错 误 提示 前 添加 了 “bean: ”前 级 。 


93 人 4 ”conditionavisitor 验证 器 
conditionalvisitor 验证 器 的 实现 类 是 由 visitor 验证 器 的 实现 类 扩展 而 来 的 ,除了 拥 
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有 visitor 验证 器 的 所 有 参数 外 ,还 具有 表 9-14 给 出 的 参数 。 
表 9-14 ”visitor 验证 器 的 参数 


参数 名 称 数据 类 型 说 明 


指定 要 计算 的 OGNL 表达 式 。 该 表达 式 基 于 Value Stack 求 值 。 如 果 
计算 结果 为 真 , 则 通过 验证 ,否则 验证 失败 


expression Boolean 


conditionalvisitor 验证 器 仅 当 参数 expression 的 值 为 true 时 , 才 会 调用 复合 属性 的 
验证 文件 。 例 如 上 节 中 给 出 的 例子 , 当 和 希望 当 用 户 选中 typel 时 ,date 属性 的 取 值 范围 为 
大 于 等 于 1970 年 1 月 1 日 ,number 取 值 范 围 为 L[1.10]; 当 用 户 选 中 type2 时 ,date 属性 
的 取 值 范围 为 大 于 等 于 2000 年 1 月 1 日 ,number 取 值 范围 为 [C100,200]。 

首先 将 上 节 中 ValidatedBean-validation. xml 的 文件 名 修改 为 ValidatedBean-ul- 
validation. xml; 然 后 将 ValidatedBean-ul-validation. xml 复制 一 份 , 放 到 同一 个 目录 中 ， 
重新 命名 为 ValidatedBean-u2-validation. xml, 并 修改 其 中 的 number 验证 范围 ,使 其 满 
足 [100,200] ;修改 date 验证 范围 ,使 其 min 参数 为 "01/01/2000”。 

修改 ValidatedAction-validation. xml, 利 用 conditionalvisitor 验证 器 对 ValidatedBean 进 
行 验证 ,如 代码 9-18 所 示 。 


代码 9-18 ”ValidatedAction-validation. xml(conditionalvisitor 验证 器 ) 


<validators> 
< field name= "name"> 
< field- validator type= "required"> 
<message> name 不 能 为 空 !< /message> 
< /field- validator> 
< /field> 
< field name= "bean"> 
<!-- 当 type=1 时 ,使 用 ValidatedBean- ul- velidaticn.yml 验证 bean 字 段 --> 
< field- validator type= "ccnditicnalvisitor"> 
< parem namer "expression"> type= = 1< /parar> 
< parem neme= "context"> ul< /paran> 
<message> Ul: < /message> 
< /field- validator> 
<! 一 当 type=2 时 ,使 用 ValidatedBean- 2- validation.xml 验证 bean 字 段 --> 
< field- validator type= "ccnditicnalvisitorn> 
< param namer "expression"> type= = 2< /parar> 
< parem neme= "context"> u2< /paran> 
<message> U2: < /message> 
< /field- validator> 
< /field> 
< /validators> 


上 述 代 码 使 用 context 参数 ,在 bean 字段 的 值 不 同时 分 别 调用 了 不 同 的 验证 文件 去 
验证 复合 属性 bean。 
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如 果 一 个 字段 被 配置 了 多 个 字段 验证 器 , 当 某 个 验证 器 验证 失败 时 ,如 果 和 希望 其 他 
验证 器 不 必 再 验证 ,可 以 将 field 元 素 的 fieldfield-validator 子 元 素 的 short-circuit 属性 值 
设置 为 true。 如 果 和 希望 普通 验证 器 在 失败 时 停止 其 他 验证 器 的 工作 ,可 以 将 validator 元 
素 的 short-circuit 属性 值 设 置 为 true。 

下 面 看 一 个 Struts 2 官方 文档 中 的 例子 ,如 代码 9-19 所 示 。 


代码 9-19 ”Struts 2 官方 文档 中 短路 验证 的 例子 


<validators> 
< 上 -字段 验证 器 1 验证 email 字段 --> 
< field name= "email"> 
< field-_ validator typer "required" short- cirouit= "troem> 
< message> You must enter a value for email.< /message> 
< /field- validator> 
< field- validator type= "erail" short~ cirouit= "true"> 
< message> Not a valid e mail.< /message> 
< /field- validator> 
< /field> 
< 上 -字段 验证 器 2, 验 证 email2 字 段 --> 
< field name= "email2"> 
< field- validator type= "required"> 
< message> You must enter a value for email?.< /message> 
< /field- validator> 
< field-_ validator type= "email"> 
< message> Not a valid e mail?.< /message> 
< /field- validator> 
< /field> 
< 上 -普通 验证 器 1 --> 
< validator type= "expression"> 
< param name= "expression"> email .equals (email?)< /parar> 
< message> Enail not the same as email?< /message> 
< /alidator> 
< 上 -普通 验证 器 2 一 > 
< validator type= "expression" short- circuit= "true"> 
< param name= "expression"> email .startsWith('mark')< /paran> 
< message> Fmail does not start with mark< /message> 
< /validator> 
< /validators> 


在 上 述 代 码 中 ,验证 字段 email 的 两 个 字段 验证 器 将 short-circuit 属性 设置 为 true， 
验证 email 字段 的 起 始 值 是 否 为 “mark” 的 普通 验证 器 2 的 shortcircuit 属性 也 设置 为 
true。 那 么 , 当 其 中 某 个 验证 器 发 生 短路 时 ,其 他 验证 器 会 受到 什么 影响 呢 ? 回答 这 个 问 
题 之 前 ,有 必要 先 了 解 验证 器 执行 的 优先 顺序 。 
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普通 验证 器 优先 于 字段 验证 器 。 普 通 验 证 器 按照 定义 的 顺序 执行 ,然后 是 字段 验证 
器 按照 定义 的 顺序 执行 。 

因此 ,代码 9-19 中 的 验证 器 将 按照 下 述 顺序 执行 。 

(1) 普通 验证 器 1 

(2) 普通 验证 器 2 

(3) 字段 验证 器 1 

(4) 字段 验证 器 2 

当 普 通 验证 器 2 发 生 短路 时 ,其 他 验证 器 不 会 被 执行 。 当 字段 验证 器 1 中 的 
required 验证 器 发 生 失 败 时 ,针对 email 字段 的 email 验证 器 将 不 会 执行 ,但 不 会 对 字段 
验证 器 2 造成 任何 影响 。 
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某 些 情况 下 , 当 验 证 条 件 比 较 复杂 时 ,使 用 内 置 的 验证 器 很 难 实现 验证 要 求 。 此 时 ， 
可 以 通过 手工 方式 进行 验证 。ActionSupport 类 提供 了 一 个 空 的 validate() 方 法 ,该 方法 
验证 Action 中 所 有 被 配置 过 的 方法 。 当 某 个 数据 验证 失败 时 ,程序 员 可 以 使 用 
addFieldError() 方 法 添加 一 条 Field 验证 错误 信息 。Action 实例 含有 Field 错误 时 ， 
Struts 2 会 将 请 求 转发 到 input 结果 视图 。 如 果 没 有 提供 input 结果 视图 ,会 打印 错误 信 
息 到 JSP 页 面 上 ,通过 二 s:fielderror /二 显示 失败 的 信息 。 

代码 9-20 演示 了 通过 Action 类 的 validate() 方 法 验证 用 户 输入 的 例子 。 


代码 9-20 ”利用 validate() 方 法 手工 验证 


Public class UserManagerAction extends ActionSupport { 
Private String userName; 
Private String password; 
// 省 略 了 gat 和 set 方 法 
Public String execute () throws Excepticn { 
Ue 
retum SUCCESS; 
} 
Public String add() throws Fxosption { 
/= 
retum SUOCESS; 
} 
Public String del () throws Exosption { 
AL/ 
retum SUCCESS; 
Public void validate() { 
/验证 用 户 名 是 否 和 保留 名 字 相同 
if£f (userName.equals ("admin") | | userName.equals ("administor")) { 
addFieldError ("userNeme", "用 户 名 不 能 为 保留 关键 字 "); 
了 
bcolean flagl= false; 
booleen flag~ false; 
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boolean 日 sg3- false; 
for (int i=0; i <password.length(); i++) { 
int dh password.charat (i); 
// 验 证 用 户 名 中 是 否 包 含 小 写字 母 
if (中 >='a' && hh <= "2") 
flagl=true; 
// 验 证 用 户 名 中 是 否 包含 大 写字 母 
if (th >='A' && hh <= "2") 
flag~ true; 
// 验 证 用 户 名 中 是 否 包 含 数字 
if (中 >='0' && hn <= "9") 
flag3 true; 
了 
/验证 密码 中 是 否 同时 包含 大 写字 母 , 小 写字 母 和 数字 
if (!(flagl & flag? & flag3)) 
adHFislqerror ("password",' 嘱 码 必 须 同时 包含 大 写字 母 ,小 写字 母 和 数字 "); 


} 


当 访 问 UserAction 类 的 execute() .add() 和 del() 方 法 时 ,首先 执行 validate() 方 法 。 
如 果 验 证 未 通过 (含有 field 错误 ) ,Struts 2 直接 越过 所 要 调用 的 方法 ,返回 给 用 户 Input 
结果 视图 或 者 原 输入 页 面 。 

Struts 2 还 支持 对 Action 指定 的 方法 进行 验证 。 当 希望 验证 Action 中 的 方法 xxx() 
时 ,可 以 将 验证 代码 放 在 Action 的 validateXxx() 方 法 中 。 例 如 , 当 希 望 UserAction 类 
只 在 用 户 访问 add() 方 法 时 ,Struts 2 才 会 执行 手工 验证 ,可 以 将 代码 9-21 中 的 validate 
0 〇 方法 的 名 字 改 成 validateAdd() ,读者 可 以 自己 尝试 一 下 。 

最 后 ,手工 验证 和 使 用 Struts 2 内 置 的 验证 器 之 间 并 不 冲突 。 使 用 手工 验证 时 ,仍然 
可 以 使 用 内 置 验 证 器 完成 一 部 分 验证 工作 。 


96 案例 6: 为 留言 板 的 注册 程序 添加 输入 验证 


本 节 将 为 留言 板 的 注册 程序 添加 输入 验证 功能 。 
961 自 定义 字段 验证 器 类 
假设 实现 用 户 注册 的 RegisterAction 类 具有 如 下 属性 : 


public class RegisterAction extends ActionSupport { 
Private String userName; 
Private String password; 
Private int gender; 
private String head; 
private String email; 


} 
假设 希望 保留 某 些 关键 字 , 不 允许 被 注册 为 用 户 名 。 此 时 ,必须 编写 自己 的 验证 
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器 类 。 
1 编写 自 定义 的 字段 验证 器 类 


用 户 自 定 义 的 字段 验证 器 可 以 从 FieldValidatorSupport 类 上 进行 扩展 ,如 代码 9-21 
所 示 。 


代码 9-21 保留 关键 字 验 证 类 (ReservedWordValidator. java) 


package notes.validate; 
import om. opensyrphony.xwork?.validator.ValidationExosption; 
import om.apensyrphony .xwork?2.validator.validators.FieldValidatorSupport; 


public class ReservedWordqyalidator extends FieldValidatorSupport { 
Private String reservedWprd= "7 /保留 关键 字 构成 的 串 ,以 逗号 分 隔 


Public void setReservedWord (String reservedWord) { 
this.reserveqWordF reservedWord; 

/Private String[] keyWords= {"manager", "note", "password"}; 

Public void validate (Cbject arg0) throws ValidationExosption { 
/获取 字段 名 
String fieldName= this.getFieldName (); 
/获取 字段 值 
String fieldqvalue= (String) this.getFieldvalue (fieldName，arg0) 7 
/字段 值 为 空 , 直 接 返 回 
if(null== fieldValue| |fieldValue.length()==0) 


retum; 
// 没 有 保留 关键 字 , 直 接 返 回 
if (reservedWord.length()== 0) 
retum; 
// 获 取保 留 关键 字 列表 
String[] keyWords= reservedWord.split (","); 
// 检 查 是 否 含有 保留 的 关键 字 
for (String k:keyWords) 
if(fieldqvalue.contains (k)) { 
this.addFieldError (fieldNamre, arg0); 
retum; 


} 


ReservedWordValidator 类 中 含有 一 个 参数 reservedWord, 所 有 不 允许 用 户 使 用 的 
关键 字 都 保存 在 这 个 参数 中 ,并 使 用 逗号 分 隔 ,其 值 来 源 于 配置 验证 文件 中 的 param 
元 素 。 

2 注册 验证 器 

验证 器 必须 在 注册 之 后 才能 使 用 。 内 置 的 验证 器 已 经 由 Struts 2 框架 注册 过 了 ,可 
以 直接 使 用 。 如 果 用 户 要 编写 自己 的 验证 器 ,必须 手工 注册 。 
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在 src 目录 下 新 建 validators. xml 文件 ,在 该 文件 中 注册 ReservedWordValidator 
类 ,验证 器 的 名 字 为 reservedWordValidator, 如 代码 9-22 所 示 。 


代码 9-22 注册 自 定义 的 验证 器 


< ?ml version= "1.0" encoding= "UIFE- 8"2> 
< !DOCTYPE validators PUBLIC 
™ /Japache Struts//xWork Validator Config 1.0//EN" 
"http://struts.apadhe.org/dtds/xwork— validator- config- 1.0.dtd"> 
<validators> 
< validator nemer "reservediordValidator" 
Class= "notes.validate.ReservedHordValidator" /> 
< /validators> 


962 编写 验证 文件 


在 用 户 输入 页 面 ,通常 会 将 性 别 (gender) 和 用 户头 像 (head) 设 置 成 radio 按钮 组 ,并 
提供 一 个 默认 值 。 在 验证 时 ,无 须 对 这 两 个 属性 进行 验证 。 因 此 ,只 需 验 证 userName、 
password 和 email 三 个 属性 ,如 代码 9-23 所 示 。 


代码 9-23 RegisterAction-validation. xml 


< ?ml versicn= "1.0" encoding= "UTF- 8"?> 
< !DOCTYFE validators PUBLIC 
™— //Apache Struts//xWork Validator 1.0.3//EN" 
"http://struts.apache.org/dtds/xwork— validator- 1.0.3.dtd"> 
< validators> 
< 上 -验证 用 户 名 --> 
< field name= "userName"> 
< field- validator type= "required" short- cirouit= "true"> 
<message> 用 户 名 不 能 为 空 < /message> 
< /field- validator> 
< !-- 使 用 reservedwordvalidator 验证 用 户 名 是 否 含有 保留 关键 字 --> 
< field- valicetor typer "recervedybrdyalicdator short- cirouit= "true"> 
<!-- 保 留 关键 字 列 表 --> 
< param neme= "reservedWord"> manager, acdninistrator, password< /parem> 
<message> 用 户 名 含有 非法 关键 字 < /nessage> 
< /field- validator> 
< field- validator type- "stringlength"> 
< param name= "minLength"> & /param> 
<message> 用 户 名 不 能 少 于 6 个 字符 < /message> 
< /field- validator> 
< /field> 
< 上 -验证 email 一 > 
< field name= "email"> 
< field- validator type= "email"> 
<message> email 格式 不 合法 < /message> 
< /field- validator> 
</field> 
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<! 一 验证 密码 一 > 
< field namer "password"™> 
< field_ validator type= "stringlength" short- cirouit— "true"> 
< param name= "minLength"> €& /paramy 
<message> 用 户 名 不 能 少 于 6 个 字符 < /message> 
< /field- validator> 
< field_ validator typer "fieldexpression"> 
< param name= "expression"> password—== password?2< /param> 
<message> 两 次 密码 不 一 致 < /message> 
< /field- validator> 
< /field> 
< /validators> 


在 利用 fieldexpression 验证 password 时 ,出 现 了 一 个 password2。 它 对 应 注册 页 面 
的 重复 密码 文本 框 的 name 属性 。 由 于 在 RegisterAction 类 中 不 需要 对 它 处 理 ,因此 并 
没有 定义 对 应 的 属性 名 。 


同步 训练 
1. 修改 案例 6 中 的 RegisterAction 类 ,利用 领域 对 象 User 接收 请 求 参数 ,利用 


visitor 验证 器 验证 用 户 输入 。 
2. 为 站 内 短信 系统 的 所 有 输入 页 面 添加 验证 功能 。 


hapter 10 


101 国际 化 和 本 地 化 


1011 国际 化 概述 


在 面向 国际 市 场 开发 软件 应 用 程序 的 过 程 中 ,程序 员 必 须 考虑 不 同 国家 文化 的 差 
异 ,让 应 用 程序 在 无 须 修改 代码 的 情况 下 就 能 支持 多 种 语言 和 数字 格式 的 显示 。 例 如 
2012 年 12 月 6 日 ,中 国人 的 书写 格式 为 2012-12-06, 美 国人 的 书写 格式 为 12/06/2012， 
英国 人 的 书写 格式 为 06/12/2012。 为 使 应 用 程序 支持 不 同 的 字符 集 和 文化 标准 ,如 日 
期 \ 时 间 、 数 字 和 货币 格式 等 ,必须 使 用 国际 化 (Internationalization) 技 术 。 国 际 化 ,又 称 
I18N, 这 是 因为 该 单词 的 第 一 个 字母 为 1, 最 后 一 个 字母 为 N,I 和 NN 中 间 共 有 18 个 
字母 。 

将 一 个 国际 化 程序 以 本 地 机 器 的 区 域 和 请 言 设置 显示 数字 格式 和 消息 化 的 过 程 称 
为 本 地 化 (Localization) ,简称 LION 。 

Java 语言 对 国际 化 编程 有 着 很 好 的 支持 。 由 于 Struts 2 技术 建立 在 Java 诸 言 的 基 
础 上 ,因此 Struts 2 具备 对 国际 化 处 理 的 技术 。 


1012 Java 对 国际 化 的 支持 


一 个 具备 国际 化 支持 的 应 用 程序 ,必须 把 针对 不 同 国家 和 地 区 的 文字 消息 放 到 不 同 
的 资源 文件 中 。 每 个 资源 文件 都 是 一 个 属性 文件 ,每 一 个 key/value 对 表示 一 个 资源 。 
资源 通常 是 本 地 化 的 String, 但 也 可 以 是 任何 Java 对 象 。 资 源 文件 以 一 种 层次 结构 建 
立 , 它 以 一 个 具有 基础 名 称 的 一 般 ResourceBundle 开始 ,然后 通过 在 ResourceBundle 的 
基础 名 上 添加 语言 和 国家 或 地 区 标识 ,构成 支持 不 同 国家 和 地 区 本 地 化 的 资源 文件 。 以 
下 是 资源 文件 命名 的 3 种 格式 。 


其 中 ,baseName 是 资源 文件 的 基础 名 称 ;language 是 语言 代码 ,定义 在 ISO-639 中 , 例 
如 汉语 的 代码 为 zh, 英 语 的 代码 为 en, 法 语 的 代码 为 fr 等 ;country 是 国家 代码 和 地 区 代码 ， 
定义 在 ISO-3166 中 ,例如 中 国 的 代码 为 CN. 美 国 的 代码 为 US, 英 国 的 代码 为 GB 等 。 
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在 Java 程序 中 ,实现 国际 化 需要 两 个 步骤 : 第 一 步 ,选择 一 个 特定 的 国家 、 地 区 和 请 
言 环境 ,实现 这 一 步 需要 用 到 java. util. Locale 类 ;第 二 步 , 根 据 Locale, 选 择 用 于 存储 和 
加 载 应 用 程序 使 用 的 资源 文件 ,可 以 通过 java. util. ResourceBundle 类 完成 。 

例如 ,选择 应 用 于 中 国 的 Locale 对 应 的 代码 。 


Iocale locale= new Iocale ("zh", "CN"); 


另外 ,在 Locale 中 还 提供 了 许多 Locale 对 象 常量 ,使 用 这 些 常量 可 以 简化 Locale 对 
象 的 构造 。 例 如 ,用 于 表示 国家 或 地 区 的 常量 (部 分 ) 如 下 : 

Iocale.CRNRFR 

Iocale.cHIR 

Ipcale.FRANCE 

Iocale.GERMPNY 

Iocale.TIRIY 

Iocale.0s 

Iocale.K 


用 于 表示 语言 的 常量 (部 分 ) 如 下 : 


Iocale.CHINESE 
Iocale.ENGLISH 
Locale.FFENCH 
Locale.GEFMAN 


在 为 应 用 程序 选择 完 国家 或 地 区 后 ,可 以 根据 需要 选择 使 用 某 一 个 资源 文件 。java. 
util, ResouceBundle 类 提供 的 用 于 获取 资源 的 方法 如 下 。 

(1) public static final ResourceBundle getBundle(String baseName) : 根据 默认 的 请 
言 环境 选择 资源 文件 。 

(2) public static final ResourceBundle getBundle(String baseName,Locale locale): 
根据 指定 的 Locale 获取 资源 文件 。 

(3) public final String getString (String key): 读 取 资源 文件 中 指定 关键 字 的 字 
符 串 。 

(4) public final Object getObject(String key) : 读 取 资 源 文件 中 指定 关键 字 的 对 象 。 

下 面 通过 一 个 例子 介绍 Java 应 用 程序 实现 国际 化 的 方法 ,程序 如 代码 10-1 所 示 。 


代码 10-1 TestI18N. java 


inport java.util.Locale; 
import java.util .ResouroeBundle; 


piblic class TestT18N { 
Public static void main(String[] args) { 
// 设 置 本 地 语言 为 简体 中 文 
Iocale localel= Locale.SIMPLIFIED CHINESE; 
// 设 置 当前 语言 所 用 到 的 资源 文件 
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ResourosBundle bundlel= 
ResourosBundle.getBundle ("resouroe", localel) ; 
// 从 资源 文件 中 读 取 key=welome 的 消息 文本 
System.out .printIn ("bundlel:" bundlel.getString ("weloome")); 


Locale locale2 new Locale ("en", "US"); 
ResourceBundle bundle~= 

ResourceBundle.getBundle ("resouroe", locale?2); 
System.cut.println ("bundle?:"+ bundle?.getString (welcome))7 
Locale.setDefault (Locale.CANALA) ; // 将 默认 的 Iccale 为 CRNDR 
ResouroeBundle bundle3= ResourosBundle.getBundle ("resouroe") ; 


System.out .print in ("bundle3:"+ bundle3.getString ("welome")); 


. 


TestI18N. java 的 功能 是 从 基础 名 称 为 resource 的 资源 文件 中 读 取 字符 串 message。 
localel 将 本 地 诸 言 设置 为 简体 中 文 , 因 此 bundlel 对 应 的 资源 文件 应 该 为 resource_zh_ 
CN. properties。locale2 将 国家 代码 设置 为 美国 ,因此 bundle2 对 应 的 资源 文件 应 该 为 
resource_en_US. properties。 当 将 默认 国家 设置 为 Locale. CANADA 后 ,bundle3 读 取 
的 资源 文件 应 该 为 resource_en_CA. properties。 

下 面 编 写 一 组 资源 文件 : resource. properties、 resource_en_ US. properties 和 
resource_zh_CN. properties。 注 意 ,这 里 没有 提供 资源 文件 resource_en_CA. properties 。 

代码 10-2 给 出 资源 文件 resource. properties 的 内 容 。 


代码 10-2 resource. properties 


Welome= Weloome! 


代码 10-3 给 出 资源 文件 resource_en_US. properties 的 内 容 。 


代码 10-3 resource_en_US. properties 


welome= Welomme,my friend\! 


相应 的 ,resource_zh_CN. properties 的 内 容 如 代码 10-4 所 示 。 


代码 10-4 resource_zh_CN. properties 


Welcome= \u6B22\u8FCFNu4F60,\u6211\u7684\u670BNu53CBNUFFO1 


实际 上 ,以 上 信息 就 是 中 文 的 “欢迎 你 ,我 的 朋友 !”。Java 应 用 中 的 属性 文件 在 编写 
时 是 不 能 直接 写 入 中 文 的 ,就 算是 写 入 了 中 文 , 读 取出 来 的 必然 是 乱码 ,因此 必须 将 相应 
的 中 文 变 为 Unicode 编码 。 

要 成 功 地 将 一 个 中 文 编码 变 为 Unicode 编码 ,可 以 使 用 JDK 开发 工具 包 中 提供 的 工 
具 native2ascii。 程 序 员 可 以 先 将 资源 文件 按照 key= value 格式 编写 一 个 临时 文件 ,例如 


第 10 章 消息 处 理 与 国际 化 < 瑟 


resource_zh_CN. tmp, 然 后 在 命令 行 下 执行 下 述 命令 。 
native2ascii rescurce zh CN.bmp resource zh ON.properties 


打开 转换 获得 的 resource_zh_CN. properties, 可 以 看 到 原文 件 中 所 有 的 非 ASCII 字 
符 都 转换 成 了 \uXXXX 形式 的 Unicode 编码 。 

提示 : 当 使 用 MyEclipse 开发 Java 应 用 程序 时 ,可 以 直接 使 用 MyEclipse Properties 
Editor 编辑 属性 文件 ,编辑 器 会 将 资源 中 所 有 非 ASCII 字符 自动 转换 为 Unicode 编码 。 

编译 并 运行 TestI18N, 得 到 如 下 输出 : 

bundlel: 欢 迎 你 ,我 的 朋友 ! 

bundle?:Weloome,my friend! 

bundle3:Welcoame! 

从 运行 结果 可 以 看 出 ,由 于 bundle3 找 不 到 资源 文件 resource_en_CA. properties, 因 
此 使 用 了 默认 资源 文件 resource. properties。 所 以 ,假设 Locale 为 使 用 中 文 的 中 国内 地 
地 区 ,资源 文件 的 基础 名 称 为 resource, ResourceBundle 的 getBundle() 方 法 将 按照 如 下 
顺序 查找 资源 文件 。 

(1) resource_zh_CN. properties 

(2) resource_zh. properties 


(3) resource. properties 
1013 资源 的 参数 化 


在 上 节 给 出 的 例子 中 ,资源 文件 中 的 资源 内 容 都 是 固定 的 。 如 果 希 望 输出 的 消息 中 
包含 一 些 动态 文本 ,可 以 在 资源 字符 串 中 使 用 占 位 符 表示 出 动态 文本 的 位 置 。 占 位 符 的 
格式 为 “{ 编 号 ;”, 其 中 编号 的 值 为 0~9, 分 别 表示 第 0 个 到 第 9 个 参数 。 

在 程序 中 ,可 以 通过 MessageFormat 类 对 资源 进行 格式 化 ,为 占 位 符 动态 设置 文本 
的 内 容 。MessageFormat 是 Format 类 的 子 类 ,Format 类 主要 实现 格式 化 操作 。 除 了 
MessageFormat 子 类 外 ,Format 还 有 NumberFormat、DateFormat 两 个 子 类 用 于 对 数字 
显示 和 日 期 的 显示 进行 格式 化 。 

例如 ,有 一 组 资源 文件 ,其 中 message-en-US. properties 的 内 容 如 代码 10-5 所 示 。 


代码 10-5 message-en-US. properties 


welcome= welome {0}, it is {1}. 


message-zh-CN. properties 的 内 容 如 代码 10-6 所 示 。 


代码 10-6 message-zh-CN. properties 


Welome= \u6B22\ UBECE{0} \UEFFOC\ LSES3\ L524D\u65F6\ U95FA\ L662F{1}\u3002 


代码 10-6 中 的 信息 实际 上 就 是 “欢迎 {0} ,当前 时 间 是 {1)。”。 
代码 10-7 是 上 述 资源 文件 的 测试 程序 。 
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代码 10-7 I18NWithParam. java 


import java.text .MessageFommat; 
import java.util.Date; 

import java-util.Iocaley 

import java.util.ResouroeBundle; 


Public class Il18NWithFaram { 
Public static void main(String[] args) { 
Iocale localel= Locale.SIMPLIFIED CHINESP; 
ResourceBundle bundlel= 
ResourosBundle.getBundle ("essage", localel); 
String welomel= bundlel .getString (welcomem) 7 
// 属 式 化 资源 ,将 “ 李 明 ” 传 递 给 第 1 个 参数 ,将 当前 时 间 传 递 给 第 2 个 参数 
String msgl= MessageFommat..format (weloomel, ' 李 明 ",new Date()); 
System.out .printIn (msgl); 


Iocale locale2= Iocale.US; 

Iocale.setpefanlt (locale2) 7 // 设 置 默认 的 Iocale 为 美国 
Resourcspundle bundle2= ResourosBundle.getBundle ("message") ; 

String welome2= bundle?.getString ("welome"); 

// 格 式 化 资源 ,将 “Jchn" 传 递 给 第 1 个 参数 ,将 当前 时 间 传 递 给 第 2 个 参数 
String msg2= MessageFormat. format (weloame?2, "John",new Date()); 
System.out .print ln (nsg?); 


3 


注意 : 上 述 代 码 中 的 语句 

Iocale.setDefault (locale?); 
非常 重要 。 当 省 略 该 语句 时 ,字符 串 msg2 中 的 日 期 格式 为 默认 Locale 下 的 格式 ,而 不 
会 是 美国 格式 (假设 默认 Locale 为 中 国 , 默 认 Locale 可 以 通过 Windows 控制 面板 中 的 
“区 域 和 语言 选项 ”设置 ) 。 

编译 并 运行 18NWithParam. java, 得 到 如 下 输出 : 


欢迎 李 明 ,当前 时 间 是 12- 12- 06 下 午 3:02。 
Welcome Jchn, it is 12/06/12 3:02 EM. 


102 Struts 2 对 国际 化 的 支持 


Struts 2 对 Java 的 国际 化 进行 了 进一步 封装 ,使 得 程序 员 在 编写 Action 类 和 制作 
JSP 页 面 时 能 够 非常 便利 地 实现 国际 化 。 

Struts 2 提供 了 加 载 国际 化 资源 文件 的 多 种 方式 ,包括 全 局 资源 文件 ` 包 范围 资源 文 
件 和 Action 范围 资源 文件 。 另 外 ,Struts 2 还 允许 使 用 il8n 标签 临时 指定 资源 文件 。 


1 全 局 资源 文件 
需要 被 整个 Web 应 用 程序 访问 的 资源 可 以 放 在 全 局 资源 文件 中 。 全 局 资源 文件 包 
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括 一 个 默认 资源 文件 和 若干 个 支持 不 同 国家 (地 区 ) 或 语言 的 资源 文件 ,文件 的 命名 方式 
与 Java 环境 的 资源 文件 命名 方式 一 致 。 全 局 资源 文件 中 的 资源 既 可 以 被 JSP 页 面 访问 ， 
也 可 以 被 Action 类 访问 。 

全 局 资源 文件 通常 放 到 Web 应 用 程序 的 WEB-INF\ classes 文件 夹 下 。 在 使 用 
MyEclipse 集成 环境 开发 时 ,可 以 放 到 项 目的 src 文件 夹 下 。 为 了 让 Struts 2 框架 能 够 找 
到 全 局 资源 文件 ,还 需要 在 struts. xml 中 配置 常量 : 


< onstant name= "struts.custam.il8n.resouroes" value= "basename" /> 
或 者 在 src 文件 夹 中 的 struts. properties 文件 中 加 入 : 

Struts.custam.ilgn.. 
其 中 ,basename 为 资源 文件 的 基础 名 称 。 

2 包 范 围 资 源 文件 

Struts 2 支持 对 资源 文件 的 模块 化 管理 。 当 一 个 Web 应 用 涉及 的 资源 比较 多 时 ,为 
了 避免 全 局 资源 文件 过 于 腾 肿 ,可 以 将 一 部 分 资源 放 到 包 范 围 资 源 文件 中 。 包 范围 资源 
文件 应 当 放 到 包 的 根 目录 中 , 仅 供 当前 包 和 子 包 中 的 类 访问 ,不 能 供 JSP 页 面 和 其 他 包 
中 的 类 访问 。 包 范围 资源 文件 命名 格式 为 : 


(1) package_language_country. properties 


basename 


(2) package_language. properties 
(3) package. properties 
其 中 ,package 是 固定 的 写法 。 


3 Acian 范 围 资源 文件 

仅 供 某 个 Action 类 访问 的 资源 可 以 放 到 Action 范围 资源 文件 中 。Action 范围 资源 
文件 放 到 Action 类 所 在 的 目录 中 ,文件 命名 格式 为 : 

(1) ActionClass Name_language_country. properties 

(2) ActionClass Name _language. properties 

(3) ActionClassName. properties 


其 中 ,ActionClassName 为 Action 类 的 简单 名 称 。 


4 资源 文件 查找 的 顺序 

在 查找 指定 key 的 资源 时 ,Struts 2 按照 如 下 顺序 搜索 资源 文件 。 

(1) 查找 与 调用 的 Action 类 同名 的 资源 文件 , 即 对 Action 范围 资源 文件 按照 特殊 
到 一 般 的 顺序 ,查找 ActionClassName_language_country. properties、ActionClassName_ 
language. properties 和 ActionClassName. properties 。 

(2) 查找 所 有 与 Action 类 的 基 类 同名 的 资源 文件 ,从 ActionSupport. properties 直 
至 Object. properties。 

(3) 查找 与 所 有 Action 类 实现 的 接口 同名 的 资源 文件 。 

(4) 依次 查找 Action 类 所 在 包 和 父 包 中 的 资源 文件 。 

(5) 查找 全 局 的 资源 文件 。 
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103 ”Stuts 2 访问 国际 化 资源 的 方式 


1031 在 Action 中 访问 国际 化 资源 


Struts 2 的 ActionSupport 类 中 提供 了 多 个 重 载 的 getText() 方 法 ,用 于 访问 国际 化 
资源 ,以 下 是 常用 的 几 个 getText() 方 法 的 原型 。 

(1) public String getText(String aTextName): 用 于 获取 key 为 aTextName 的 资 
源 。 如 果 没 有 找到 ,将 返回 aTextName。 

(2) public String getText(String aTextrName, String defaultValue) : 用 于 获取 key 
为 aTextName 的 资源 。 如 果 没 有 找到 ,将 返回 defaultValue。 

(3) public String getText(String aTextName，List 一 ?二 args): 用 于 获取 key 为 
aTextName 的 资源 。 参 数 args 用 于 替换 资源 中 的 占 位 符 ,List 中 的 第 一 个 元 素 替 换 占 
位 符 {0) ,第 二 个 参数 替换 占 位 符 {1)…… 

(4) public String getText(String key, String[] args) : 用 于 获取 key 为 aTextName 
的 资源 ,参数 args 用 于 奉 换 资源 中 的 占 位 符 , 数 组 中 的 第 一 个 元 素 蔡 换 占 位 符 {0) ,第 二 
个 参数 蔡 换 占 位 符 {1)…… 

另外 ,ActionSupport 类 还 提供 了 一 个 getTexts() 方 法 。 


Public ResourosBundle getTexts (String aBundleName) 


用 于 获得 名 为 aBundleName 的 ResourceBundle 对 象 。 通 过 该 对 象 ,可 以 访问 基础 
名 称 为 aBundleName 的 资源 文件 中 的 资源 。 

下 面 通 过 一 个 例子 讨论 如 何在 Action 中 访问 国际 化 资源 。 

修改 前 面 给 出 的 resource_zh_CN. properties 资源 文件 ,如 代码 10-8 所 示 。 


代码 10-8 ”修改 后 的 resource_zh_CN. properties 


WElcome= \u6B22\u8FCENu4F60, \u6211\u7684\u670BNu53CBNUFFO1 
hello= \u6B22\u8FCE{0}NUEFOCNu73B0N\u5728\u65F6\u95F4{1}N\u3002 
UserName= \u7528\u6237\u540D 

Password= \u5BC6\u7801 

Submit= \u63DO\ uA4EA4 


上 述 内 容 实 际 如 下 : 


weloome= 欢 迎 你 ,我 的 朋友 ! 
hello= 欢 迎 {0}, 现 在 时 间 {1}。 
username= 用 户 名 
Fassword 密 码 

sutmit= 提 交 


修改 前 面 给 出 的 message_zh_CN. properties 资源 文件 ,增加 如 下 内 容 。 


hello= \u4F60\u597DNu5417NuEF1F 
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上 述 内 容 实 际 如 下 : 
hello= 你 好 吗 ? 


在 struts. xml 中 将 resource. properties 配置 为 全 局 资源 文件 。 代 码 10-9 定义 了 一 
个 Action 类 ,并 演示 了 在 Action 类 中 访问 资源 文件 的 方法 。 


代码 10-9 I18NTestAction. java 


import java.util.Date; 

jimport java.util .ResouroceBundle; 

jimport om.cpensyrphony .xwork2.ActionSupport; 

Puiblic class T18NTestAction extends ActicnSupport { 
public String execute () { 


String welcome= getText ("welome") ; MO 
System.cut.println (weloome= 叶 welcome); 
String hello= getText ("hello", 

new String[]{'" 醒 明 ",new Date() .tostring()}); VD 


System.out .printIn ("hello= "+ hello); 


ResourosBundle bundle= getTexts ("message") ; /9 
String msgHello= bundle.getString ("hello"); //@ 
Systemcut.println ("message: :hello= "+ msgHell0) ; 

retum SUOCESS; 


3 


语句 获取 了 全 局 资源 文件 中 Key 为 welcome 的 资源 。 

语句 @ 在 获取 全 局 资源 文件 中 Key 为 hello 的 资源 时 ,利用 字符 串 数组 向 资源 传递 
了 两 个 参数 ,用 于 替换 资源 中 的 占 位 符 。 

语句 @ 利 用 getTexts() 方 法 读 取 基 础 名 称 为 message 的 资源 文件 ,并 利用 @ 从 中 获 
取 Key 为 hello 的 资源 。 

访问 II8NTestAction ,获得 如 下 输出 : 

message= 欢 迎 你 ,我 的 朋友 ! 


hello= 欢 迎 李 明 ,现在 时 间 Fri Dec 07 09:50:13 CsT 2012。 
message: :hello= 你 好 吗 ? 


1032 在 JSP 页 面 中 访问 国际 化 资源 


在 JSP 页 面 的 一 般 文本 中 显示 国际 化 资源 ,需要 使 用 Struts 2 提供 的 text 标签 和 
il8n 标签 。 

1 tet 标 签 

text 标签 用 于 显示 国际 化 资源 .相当 于 调用 了 getText() 方 法 的 property 标签 。text 
标签 常用 的 属性 如 表 10-1 所 示 。 
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表 10-1 text 标 签 的 属性 
属 性 名 是 否 必需 | 类 型 说 明 
name 是 String ”| 所 要 访问 的 国际 化 资源 的 Key 


如 果 没 有 找到 指定 消息 ,将 从 ValueStack 中 搜索 ,此 时 
相当 于 一 个 property 标签 。 默 认 值 为 true 


var 否 String 允许 用 户 根据 该 属性 引用 var 


searchValueStack 否 Boolean 


例如 ,下 面 的 text 标签 将 访问 Key 为 welcome 的 资源 。 

< 3:text name= "welome'> < /s:text> 

如 果 和 希望 访问 带 有 占 位 符 的 资源 ,可 以 利用 param 标签 为 text 标签 传递 参数 。 例 
如 ,访问 上 节 中 的 hello 标签 ,可 以 使 用 下 面 的 形式 。 


< s:text name= "hello"> 


<s:paran> 李 明 < /s:parar> 
< 3s:param> 2012- 12- 07 19:20:00< /s:parar> 
< /s:text> 


另外 ,还 可 以 使 用 动态 值 作为 text 标签 的 属性 ,例如 : 


< 3:text name= "hello"> 
< 3:paran> < s:property value= "userName"/> < /3:paran> 
< s:paran> < 3:property value= "now"/> < /s:param> 

< /s:text> 


在 利用 text 标签 显示 国际 化 资源 时 ,所 读 取 的 资源 文件 取决 于 Action 类 的 Bundle。 
2 i 标签 
il8n 标签 用 于 读 取 一 个 bundle, 并 将 其 放 到 ValueStack 上 。 通 过 il8n 标签 ,程序 员 
可 以 让 text 标签 显示 任意 一 个 bundle 对 应 的 资源 文件 中 的 资源 。il8n 标签 仅 有 一 个 
name 属性 ,该 属性 用 于 指定 所 要 读 取 的 资源 文件 的 基础 名 称 。 
下 面 在 10.3.1 小 节 的 基础 上 ,为 18NTestAction. java 编写 一 个 结果 页 面 ,如 代 
码 10-10 所 示 。 
代码 10-10 在 JSP 页 面 中 输出 国际 化 资源 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 
< $@ taglib uri= "/struts- tags" prefixe "s" $> 
<html> 
<head> 
<title> Intermationalization< /title> 
< /head> 
<body> 
< 二 -访问 全 局 资源 文件 中 的 welome 资 源 一 > 
< 3:text namer "welome"> < /s:text> 
<br/> 
< ! 一 访问 全 局 资源 文件 中 的 hello 资 源 , 并 传递 两 个 参数 一 > 


< s:text name= "hello"> 
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<s:paran> 李 明 < /s:paranp 

< s:param> 2012- 12- 07 19:20:00< /s:param> 

< /s:text> 

<br/> 

< 上 -了 np 标签 访问 message 资 源 文件 --> 

< s:il8n namer "message"> 
< 上 -访问 基础 文件 名 为 message 的 资源 文件 中 的 hello 资 源 --> 
< s:text name= "hello"> < /s:text> 

</s:il8n> 

< /body> 
</htm> 


代码 10-10 中 给 出 了 详细 的 注释 ,在 此 不 再 袭 述 。 在 struts. xml 配置 18NTestAction. 
java 和 该 页 面 后 ,在 浏览 器 中 访问 Action, 页 面 显 示 内 容 如 下 : 
欢迎 你 ,我 的 朋友 ! 


欢迎 李 明 ,现在 时 间 2012- 12- 07 19:20:00。 
你 好 吗 ? 


1033 在 表单 标签 的 属性 中 访问 国际 化 资源 


除了 可 以 在 JSP 页 面 中 输出 一 般 的 国际 化 资源 外 ,也 可 以 对 表单 中 的 标签 进行 国际 
化 。 在 表 6-15 中 给 出 的 表单 标签 的 通用 属性 中 有 一 个 属性 key, 当 为 表单 标签 指定 该 属 
性 时 ,Struts 2 将 使 用 国际 化 资源 文件 中 对 应 的 资源 作为 HTML 表单 元 素 的 name \label 
和 value。 


代码 10-11 给 出 了 一 个 在 表单 标签 中 访问 国际 化 消息 的 例子 。 


代码 10-11 il8nForm. jsp 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 
< $@ taglib uri= "/struts- tags" prefix= "s" $> 
<html> 
<head> 
<title> IISN Fomme /title> 
< /head> 
<body> 
< 3:fom action= "il8nFomm"> 
< s:textfield key= "userNeme"> < /s:textfield> 
< s:password key= "password"> < /s:password> 
< s:submit key= "submit"> < /s:submit> 
</s:fom> 
< /body> 
</htm> 


由 于 上 述 代 码 中 没有 为 textfield 标签 和 password 标签 指定 属性 name,Struts 2 会 
直接 用 属性 Key 作为 属性 name。 在 浏览 器 中 查看 il8nForm. jsp, 效 果 如 图 10-1 所 示 。 
最 后 ,提醒 大 家 ,只 有 当 JSP 的 表单 和 表单 标签 的 主题 不 为 simple 时 ,才能 使 用 表单 
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园 I188 Forn x 
4 Gel127.0.0. 


用 户 名 : 
密码 : 


用 到 


图 10-1 表单 标签 访问 国际 化 资源 
标签 的 key 属性 访问 国际 化 资源 。 


104 案例 7: 为 留言 板 程序 添加 国际 化 支持 


本 节 将 为 留言 板 程序 添加 中 、 英 文 两 种 语言 支持 ,允许 用 户 通过 一 个 下 拉 列 表 框 自 
由 选择 需要 使 用 的 语言 环境 。 一 旦 用 户 选择 了 某 种 语言 ,在 接 下 来 的 每 个 页 面 中 都 将 使 
用 该 种 语言 浏览 。 

为 实现 上 述 功能 ,需要 借助 Struts 2 提供 的 il8n 拦截 器 。 在 执行 Action 的 方法 之 前 ， 
il8n 拦截 器 的 intercept() 方 法 先 查找 一 个 名 为 requested_locale 的 参数 。 如 果 能 够 找到 该 参 
数 ,il8n 将 其 转换 成 一 个 Locale 对 象 ,并 保存 在 session 的 WW_TRANS_I18N_LOCALE 参 
数 中 。 可 以 通过 修改 该 参数 中 保存 的 Locale 对 象 , 改 变 应 用 程序 运行 的 语言 环境 。 


1041 编写 资源 文件 


限于 篇 幅 , 本 节 只 给 出 留言 板 注册 页 面 的 国际 化 支持 。 
代码 10-12 所 示 是 注册 页 面 的 简体 中 文 的 资源 文件 。 注 意 ,为 了 方便 读者 阅读 ,该 文 
件 没有 转换 成 Unicode 编码 形式 ,读者 可 自行 使 用 native2ascii 工具 进行 转换 。 


代码 10-12 resource_zh_CN. txt 


title= 留 言 板 一 一 注册 
userName= 用 户 名 
Password= 密码 
repassword= 重 复 密码 
erail= 邮 箱 
gender= 性 别 
gender.male= 男 
gender.female= 女 
Ehoto= 选 择 头像 
sumit= 注 册 
reset= 重 填 


chinese= 中 文 版 
english= 英 文 版 
selectlanguage= 请 选择 语言 


代码 10-13 所 示 是 注册 信息 的 英文 资源 文件 。 
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代码 10-13 resource_en_US. properties 


1042 JSP 页 面 的 国际 化 


为 了 便于 用 户 选择 语言 环境 ,可 以 在 注册 页 面 添加 一 个 下 拉 列 表 框 ,并 在 其 中 列 出 
留言 板 程序 所 支持 的 语言 环境 。 为 此 ,采用 一 个 Map 填充 下 拉 框 。 其 中 ,Map 的 key 为 
java. util. Locale 常量 ,value 为 国际 化 资源 。 

< 3:select name= "request locale" 

1ist= 啡 {@ java.util.Locale@ CHINESE:getText ('dhinese'), 

@ java.util.Locale@ US:getText ('english')}" 
key= "selectlanguage" 
value= "# session locale=null ? locale : # session locale"/> 

这 里 使 用 表示 中 国 的 java. util. Locale@CHINA 常量 (字符 串 的 值 为 zh_CN) 对 应 前 
面 定 义 的 资源 文件 resource_zh_CN. properties, 表 示 美 国 的 java. util. Locale@US 常量 
(字符 串 的 值 为 en_US) 对 应 前 面 定 义 的 资源 文件 resource_en_US. properties。 

另外 ,为 了 获取 应 用 程序 使 用 的 语言 环境 ,可 以 读 取 session 对 象 的 WW_TRANS_ 
D8N_LOCALE 参数 ,并 将 该 参数 的 值 作为 下 拉 列表 框 当前 选中 的 值 。 

当 用 户 选择 某 个 语言 环境 后 ,下 拉 列 表 框 的 值 将 作为 request_locale 参数 传递 给 
Struts 2 框架 ,由 il8n 拦截 器 根据 该 参数 设置 应 用 程序 的 语言 环境 。 

代码 10-14 给 出 了 注册 页 面 完整 的 代码 。 


代码 10-14 ”注册 页 面 (reg.jsp) 


< $@ page language= "java" pageEnooding= "UTF- 8"%> 
<%@ taglib uri= "/struts- tags" prefix= "s"%> 
<htm> 

<head> 

<title> < s:text name= "title"/>< /title> 

< script typer "text/javascript"> 

finction lang cnchanged() { 
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poument .getElementByTd ("langFom") .suibmit (); 
} 
< /script> 
< /head> 
<body> 
<!-- 将 Session 对 象 的 mW TRANS T18N IOCAIE 参数 保 存在 sessicn locale 中 --> 
< s:set name= "session locale" value= 啡 session['WH TRANS T18N IOCATE']"/> 
<!-- 下 面 的 fom 用 于 将 下 拉 列 表 框 选项 的 改变 提交 给 服务 器 --> 
< fom action= "< s:url/> " id "langFom" style= "background- color:# e989e; "> 
< s:select name= "request. locale" 
list="# {@ java.util .Locale@ CHINESE:getText ('chinese'), 
@ java.util.Locale@ US:getText ('english')}" 
key= "selectlanguage" 
Value= 啡 session locale=null ? locale : # sessicn locale" 
cnchange= "lang_onChanged()" /> 
< /fom> 
<!-- ”用 户 注册 表单 一 > 
< s:form namer "regFom" action= "register.action" method "post"> 
< s:textfield key= "userName"> < /s:textfield> 
< 3:password key= "repassword"> < /3:password> 
< s:textfield key= "email"> < /s:textfield> 
< s:radio list= "# {1:getText ('gender .male'), 
0:getText ('gender .female') }" key= "gender" value= "1"> < /s:radio> 
< s:radio list= 啡 {"1.gif':'< img src- images/head/1.gif >', 
'2.gif':'< img src= images/head/2.gif> ', 
'3.gif':'< img src= images/head/3.gif> ', 
'4.gif':'< img sro- images/head/4.gif> ', 
"5.gif':'< img src= imges/head/5.gif><br/>", 
'6.gif':'< img sro- images/head/6.gif> ', 
"7.gif':'< img sro- images/head/7.gif> ', 
'8.gif':'< img sro- images/head/8.gif> ', 
'9.gif':'< img sro- images/head/9.gif> ', 
"10.gif':'< img srcr images/head/10.gif>' 
}" name= "head" value= "'1.gif'" key= "photo"> < /s:radio> 
<s:stmit key= "submit"> < /s:submit> 
< /s:fom> 
< /body> 
< /html> 


在 上 述 代码 中 , 当 列 表 框 的 选项 发 生 改 变 时 ,利用 JavaScript 自动 将 langForm 表单 
提交 给 服务 器 。 

图 10-2 所 示 为 注册 页 面 在 语言 环境 为 中 文 时 的 显示 效果 。 当 选择 以 英文 浏览 时 , 注 
册页 面 的 显示 效果 如 图 10-3 所 示 。 

注意 : 由 于 页 面 需要 访问 session 对 象 ,因此 不 能 在 浏览 器 中 直接 访问 JSP 页 面 ,而 
应 该 通过 Action 浏览 。 

细心 的 读者 可 能 注意 到 了 ,在 图 10-3 给 出 的 英文 版 注册 页 面 中 出 现 了 一 条 不 协调 的 
文字 一 一 “用 户 名 不 能 为 空 ”, 这 是 在 前 面 的 章节 为 userName 字段 配置 的 验证 错误 信息 。 
显然 ,在 英文 版 的 页 面 中 出 现 这 样 的 文字 是 不 合适 的 ,下 面 将 研究 如 何 国际 化 校 验 信息 。 
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10-3 注册 页 面 (英文 环境 ) 
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第 8 章 介绍 了 如 何 利 用 Struts 2 的 校 验 框架 来 验证 用 户 输入 的 信息 , 当 用 户 输入 信 
息 不 符合 应 用 的 约束 时 ,validation 拦截 器 会 把 验证 文件 中 读 取 到 的 提示 放 入 Field 级 别 
或 Action 级 别 的 错误 消息 中 ,然后 在 JSP 页 面 利用 fielderror 标签 或 actionerror 标签 提 
示 给 用 户 。 在 第 8 章 的 例子 中 ,所 有 的 错误 提示 都 硬 编码 在 验证 文件 中 。 对 于 一 个 支持 
国际 化 的 应 用 程序 来 说 ,显然 这 是 不 符合 要 求 的。 下 面 通过 留言 板 注册 程序 来 研究 如 何 
实现 验证 信息 的 国际 化 。 

首先 ,编写 提供 验证 信息 的 国际 化 资源 文件 。 由 于 这 部 分 资源 仅 在 注册 时 使 用 ,所 
以 应 该 使 用 Action 范围 的 资源 文件 进行 存储 。 代 码 10-15 给 出 了 注册 验证 信息 的 中 文 
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部 分 ,为 了 便于 用 户 阅 读 ,没有 将 其 转换 成 Unicode 编码 。 
代码 10-15 ”RegisterAction-zh-CN. properties 的 内 容 


userName.erpty= 用 户 名 不 能 为 空 
userName.invalid= 用 户 名 含有 非法 关键 字 
userName.minLength= 用 户 名 不 能 少 于 6 个 字符 
email.invalid- email 格式 不 合法 
Password.minTengtt= 密 码 不 能 少 于 6 个 字符 
password.different= 两 次 密码 不 一 臻 


RegisterAction-en-US. properties 是 验证 信息 的 英文 资源 文件 ,如 代码 10-16 所 示 。 


代码 10-16 RegisterAction-en-US. properties 


UserName.empt username cannot be empty! 

userName .minLength= The username length can not be less than 6 characters! 
Emil.invalid= email is invalid! 
password.minLength= The password length can not be less than 6 characters! 
password.different= Password does not match the confizm password! 


接 下 来 ,利用 上 述 两 个 资源 文件 实现 验证 信息 的 国际 化 。 

Struts 2 验证 文件 中 的 message 标签 用 于 指定 产生 错误 时 的 提示 信息 ,该 标签 有 一 
个 key 属性 。 当 将 key 属性 的 值 指定 为 国际 化 资源 中 的 某 个 资源 的 key 时 ,就 能 够 实现 
验证 信息 的 国际 化 。 

代码 10-17 给 出 了 添加 了 国际 化 支持 的 留言 板 注册 程序 的 验证 文件 。 


代码 10-17 RegisterAction-validation. xml 


< ?ml versicn= "1 .0" enooding= "UIF- 8"?> 

< !DOCTYEFR validators FUBLIC 
" //Apache Struts//XWork Validator 1.0.3//EN" 
"http://struts.apache.org/dtds/xwork- validator- 1.0.3.dtd"> 


< validators> 
< 上 -- 验 证 用 户 名 --> 
< field name= "userName"> 


< field- validator type= "required" short- circuit= "true"> 
< message key= "userNere .enpty"> < /message> 
< /field- validator> 
< 上 -使 用 reservedworcValidator 验证 用 户 名 是 否 含 有 保留 关键 字 --> 
< field- validator type= "reservedWordValidator" 
short- circuit= "true"> 
< !-- 保 留 关键 字 列表 -> 
< param name= "reservedWord"> manager,administrator,password 
< /parar> 
< message key= "userNere.irvalid"> < /message> 
</field- validator> 
< field- validator typer "stringlength"> 
< param name= "minLength"> 6c /param> 
< message key= "userNerre .minLength"> < /message> 
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< field name= "password"> 
< field- validator type= "stringlength" short- circuit= "true"> 
< param name= "minLength"> 6 /param> 
< message key= "password.minLength"> < /message> 
< /field- validator> 
< field- validator type= "fieldespression"> 
< param name= "expression"> password= =password?< /param> 


注意 ; 当 同 时 为 message 标签 指定 值 和 key 属性 时 ,起 作用 的 为 Key 属性 。 例 如 下 
面 的 代码 : 


<message key= "userName.invalid"> 用 户 名 中 包含 非法 的 关键 字 !< /message> 
当 发 生 错误 时 ,Struts 2 提示 给 用 户 的 是 资源 userName. invalid 的 内 容 , 而 不 会 将 字 
符 串 “用 户 名 中 包含 非法 的 关键 字 1” 提 示 给 用 户 。 


图 10-4 给 出 了 最 终 的 注册 页 面 的 英文 版 。 从 图 中 可 以 看 到 ,验证 信息 已 经 实现 了 国 


国 iptes--Yelcone..，> 入 


€ 3 ©|©127.0.0.1:8080/notes/r .a0tion?requsst_locale=en_US 。 安 | 碟 
[Enoish = 


usernane cannot be empty! 
Yserllane: 
Password: ES 
RePacemcrd: | | 
Email: 
Gender; Flale MFenale 


情人 
.人 2a 


Register 


Choose your avatar: 


图 10-4 留言 板 注册 页 面 的 英文 版 
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同步 训练 


1. 编程 测试 资源 文件 的 加 载 顺 序 。 

2. 为 留言 板 程序 的 登录 页 面 、 留 言 页 面 和 查看 留言 内 容 页 面 提 供 国 际 化 支持 。 

3. 为 站 内 短信 系统 添加 国际 化 支持 。 要 求 对 国际 化 资源 实现 模块 化 处 理 , 并 根据 资 
源 使 用 范围 的 不 同 , 将 其 放 入 不 同 范围 的 资源 文件 。 
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11.1 类 型 转换 概述 


在 Web 应 用 中 ,页 面 提交 的 数据 是 以 请 求 参 数 的 形式 发 送 给 服务 程序 的 ,每 一 个 请 
求 参数 都 是 字符 串 类 型 的 数据 。 在 服务 程序 端 , 必 须 将 这 些 数据 转换 成 特定 的 数据 类 
型 ,例如 java. model. Date 或 float 类 型 ,然后 进行 处 理 。 

在 传统 的 JSP 编程 中 ,类 型 转换 的 过 程 通常 需要 程序 员 编 码 完成 。 而 在 Struts 2 
中 ,基本 类 型 和 字符 串 之 间 的 类 型 转换 能 够 通过 内 置 的 类 型 转换 器 自动 完成 。 只 要 用 户 
输入 的 数据 符合 Action 中 相应 属性 的 类 型 要 求 ,在 execute() 方 法 执行 之 前 ,Struts 2 能 
够 将 其 自动 转换 为 合适 的 数据 类 型 。 例 如 ,对 于 留言 板 程序 中 的 用 户 注册 页 面 , 在 输入 
了 用 户 名 、 密 码 和 性 别 ,并 点 击 提交 之 后 ,Struts 2 自动 将 提交 的 性 别 由 字符 串 类 型 转换 
成 为 Int 类 型 ,然后 将 转换 后 的 Int 数据 赋值 给 Action 的 User. gender 属性 (注意 ,User. 
gender 的 类 型 为 Int 型 ,其 中 “0” 表 示 男 ,“1” 表 示 女 )。 


1111 Stuts 2 内 置 的 类 型 转换 器 


Struts 2 内 置 的 类 型 转换 器 提供 了 对 类 型 转换 的 无 缝 支持 ,能 够 处 理 绝 大 多 数 的 需 
求 , 例 如 将 String 转换 为 Int 等 简单 类 型 ,以 及 将 String 转换 到 Date 等 对 象 类 型 。 
Struts 2 内 置 的 类 型 转换 器 实现 String 类 型 和 下 述 类 型 的 自动 转换 。 

(1) int/Integer,float/Float,long/Long,double/Double: 在 字符 串 和 数值 型 数据 之 
间 转 换 。 

(2) boolean/Boolean: 在 字符 串 和 布尔 型 数据 之 间 转 换 。 

(3) char/Character: 在 字符 串 和 字符 之 间 转 换 。 

(4) date: 在 字符 串 和 日 期 数据 之 间 转 换 。 转 换 时 ,将 根据 Locale 设置 ,利用 
SHORT 格式 进行 输入 和 输出 处 理 。 

(5) BigInteger/BigDecimal: 在 字符 串 和 大 整 型 数据 /大 浮 点 数 型 数据 之 间 转 换 。 

(6) Enumeration: 在 字符 串 和 枚 举 类 型 数据 之 间 转 换 。 

(7) Array: 在 字符 串 和 数组 数据 之 间 转 换 。 在 转换 时 ,Struts 2 将 尝试 使 用 数组 元 
素 类 型 对 应 的 转换 器 对 每 个 元 素 进 行 转换 。 

(8) Collection: 在 字符 串 和 集合 类 型 数据 之 间 转 换 。 在 转换 时 ,如 果 无 法 确定 元 素 
的 类 型 ,Struts 2 将 该 元 素 视 为 String 类 型 ,并 且 创 建 一 个 ArrayList 来 存放 元 素 。 
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下 面 举 一 个 Struts 2 对 枚 举 类 型 数据 自动 转换 的 例子 。 
代码 11-1 给 出 了 一 个 枚 举 类 SchoolEnum 的 定义 。 


代码 11-1 枚 举 类 SchoolEnum 


Piblic enum SchoolEnum { 
计算 机 学 院 , 信 控 学 院 , 理 学 院 ,石化 学 院 ; 


代码 11-2 给 出 了 使 用 SchoolEnum 的 Action 类 。 


代码 11-2 SchoolAction 


import org.chl1 .model.SchoolEnum; 
import om.opensyrphony .xwork?2.ActionSupport; 
Public class SchoolAction extends ActionSupport { 
SchoolEnum school; 
// 省 略 了 school 的 getter 和 setter 方 法 
Public String execute () throws Exosption { 
Teturn SUOCESS; 


4 


代码 11-3 给 出 了 一 个 school. jsp 页 面 。 其 中 ,列表 框 school 绑 定 到 SchoolAction 


类 的 school 属性 上 。 
代码 11-3 school. jsp 


< $@ Page language= "java" pageEnooding= "UIF- 8"%> 
< $8@ taglib prefix= "s" uri= "/struts- tags" $> 
<html> 
<head> < title> 选 择 学 院 < /title>< /head> 
<body> 
< s:fom action= "school"> 
<s:select list="{' 计 算 机 学 院 ',' 信 控 学 院 ',' 理 学 院 ',' 石 化 学 院 '}" 
label= "所 在 学 院 " name= "schoo1"> < /3:select> 
<s:submit>< /s:submit> 
< /s:fom> 
你 所 在 的 学 院 为 :< s:property value= "schoo1"/> 
< /body> 
</htm> 


当 用 户 在 school. jsp 页 面 选择 所 在 学 院 并 提交 后 .Struts 2 框架 将 请 求 数据 填充 给 
SchoolAction 的 school 属性 时 ,会 调用 xWork 提供 的 DefaultTypeConverter 类 将 数据 
转换 成 SchoolEnum 类 型 。 同 样 ,在 返回 结果 页 面 时 ,Struts 2 将 SchoolEnum 类 型 的 


school 转换 成 String 类 型 数据 进行 响应 。 
在 此 省 略 了 上 述 例子 的 struts. xml 配置 ,读者 可 以 自行 补充 完成 。 
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14L12 类 型 转换 时 装配 对 象 的 原则 


当 利用 表单 为 一 个 JavaBean、List 和 Map 对 象 输入 数据 时 ,Struts 2 的 类 型 转换 实 
现 了 将 客户 输入 直接 装配 成 一 个 对 象 ,而 不 需要 使 用 基本 类 型 或 字符 串 类 型 的 表单 参数 
值 作为 中 间 值 ,然后 由 程序 员 在 Action 的 execute() 方 法 中 把 这 些 中 间 值 组 装 成 完整 的 
对 象 。Struts 2 在 类 型 转换 时 装配 对 象 的 原则 如 下 。 

(1) 当 表单 输入 的 是 一 个 组 合 的 OGNL 表达 式 时 ,Struts 2 首先 计算 出 该 表达 式 的 
值 ,然后 利用 该 值 自动 创建 和 装配 实际 对 象 。 

(2) 当 表 单 标签 的 name 对 应 Action 类 中 JavaBean 类 型 的 属性 时 ,Struts 2 自动 创 
建 一 个 JavaBean 对 象 ,并 为 其 赋值 。 需 要 注意 的 是 ,Struts 2 只 能 自动 创建 和 装配 遵守 
JavaBean 规范 的 对 象 , 也 就 是 说 ,该 对 象 必 须 提供 无 参 构造 函数 ,以 及 为 每 个 public 类 型 
的 属性 提供 getter 和 setter 方法 。 例 如 , 某 个 Action 类 有 一 个 名 为 note 的 JavaBean, 如 
果 希 望 Struts 2 创建 note 对 象 ,那么 Action 类 必须 提供 一 个 setPerson() 方 法 。 另 外 , 当 
为 note. title 赋值 时 ,调用 getNote(). setTitle() 方 法 。 

(3) 当 表 单 中 具有 多 个 同名 的 标签 时 ,Struts 2 尝试 将 其 装配 为 一 个 数组 或 List 
对 象 。 

在 Java 应 用 开发 过 程 中 ,程序 员 经 常会 遇 到 NullPointerException 的 问题 。 产 生 这 
个 问题 的 原因 是 引用 了 一 个 没有 初始 化 的 对 象 。Struts 2 在 进行 类 型 转换 过 程 中 ,如 果 
发 现 没 有 初始 化 的 对 象 ,会 自动 建立 一 个 空 的 Object 的 引用 。 这 一 功能 的 支持 是 由 
Parameter 拦截 器 完成 的 。 该 拦截 器 在 开始 处 理 参 数 之 前 ,将 Action Context 中 一 个 名 
为 CREATE_NULL_OBJECTS 的 键 值 设置 为 true。 这 样 ,出 现 NullPointerException 
异常 的 OGNL 表达 式 将 被 自动 临时 中 断 ,系统 将 通过 创建 所 需 对 象 的 方法 来 自动 尝试 解 
决 空 值 引用 。 

Struts 2 在 处 理 空 值 引用 时 ,有 如 下 规则 。 

(1) 当 属 性 被 声明 为 Collection 或 者 List 时 ,返回 一 个 ArrayList 对 象 来 赋 给 空 
引用 。 

(2) 当 属 性 声明 为 Map 时 ,返回 一 个 HashMap 对 象 赋 给 空 引用 。 

(3) 当 属 性 声明 为 一 个 简单 带 有 无 参数 构造 方法 的 JavaBean 时 ,调用 无 参数 的 构造 
方法 生成 这 个 JavaBean 的 实例 并 赋 给 空 引用 。 


112 复杂 对 象 类 型 的 转换 


Struts 2 对 于 数组 、List 和 Map 等 集合 类 型 的 转换 提供 了 很 好 的 支持 。 为 了 支持 集 
合 类 型 的 转换 ,需要 使 用 泛 型 技术 。 本 节 对 常用 集合 类 型 的 转换 进行 详细 讨论 。 
1121 数组 和 Li 的 类 型 转换 


对 于 需要 快速 录入 批量 数据 的 场合 ,可 以 使 用 数组 或 List 接收 用 户 输入 的 数据 。 下 面 
讨论 一 个 利用 List 保存 部 门 信息 的 例子 。 代 码 11-4 给 出 了 一 个 JavaBean 类 Department。 
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代码 11-4 Department. java 


Package org.chll .model; 
Public class Department { 

private int deptno; 

private String dName; 

private String loc; 

// 省 略 了 depino、dName 和 loc 的 getter 和 setter 方 法 
iE 


提示 : 在 使 用 myEclipse 自动 生成 Department 类 的 各 个 属性 的 getter 和 setter 方 
法 时 ,dName 的 getter 和 setter 方法 被 命名 为 getdName() 和 setdName()。 使 用 时 ,Java 
运行 环境 无 法 访问 dName 属性 ,必须 将 其 修正 为 getDName() 和 setDName()。 因 此 , 尽 
可 能 不 要 以 首 字母 为 小 写字 母 ,第 2 个 字母 为 大 写字 母 的 形式 命名 Java 属性 。 如 果 非 要 
这 么 做 ,一 定 要 手工 修改 myEclipse 自动 生成 的 getter 和 setter 方法 名 。 

代码 11-5 给 出 的 DepartmentAction 类 利用 List 对 象 保存 了 添加 的 部 门 信息 。 
DepartmentAction 类 中 包含 两 个 List 属性 , 均 使 用 了 泛 型 技术 。 其 中 ,memo 中 存放 的 
是 简单 数据 类 型 的 对 象 ,depts 中 存放 的 是 JavaBean。 注 意 ,depts 和 memo 并 没有 实例 
化 , 当 Struts 2 为 其 填充 数据 时 ,将 自动 进行 实例 化 。 


代码 11-5 DepartmentAction. java 


Package org.chll.acticny 
jimport java.model .List; 
jimport org.dhl] .model .Department; 
jimport om.opensyrphony .xwork2.ActionSupport; 
Public class DepartmentAction extends Actionsupport { 
Private List< Department> depts; 
Private List< String> memo; 
// 省 略 了 depts 和 mem 的 getter 和 setter 方 法 
Public String execute() { 
retum SUOCESS; 
} 
和 


代码 11-6 是 用 于 添加 部 门 信息 的 JSP 页 面 ,页 面 提交 的 结果 将 交 由 DepartmentAction 
处 理 。 请 注意 页 面 中 为 DepartmentAction 的 depts 和 memo 属性 提供 数据 的 TextField 
的 name 的 写法 。 


代码 11-6 ”添加 部 门 的 JSP 页 面 (addDept. jsp) 


< $8 page language= "java" FagsEncodingr "UTF- 8"%> 
< $8 taglib prefix= "s" uri= "/struts- tags" $> 
<html> 

<head> 
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<title> 添 加 部 门 < /title> 
< /head> 
<body> 
< s:fom acticnr rtEptnt' theme= "sinplen methode "post" namespaoe= "/list"> 
<table> 
<tr> 
<t> 部 门 编码 < /th> 
<t> 部 门 名 称 < /th> 
<th> 办 公 地 点 < /th> 
<th> 备 注 < /th> 
</tr> 
< s:iterator value= "new int [2]" status= "st"> 
<tr> 
<td> 
< s:textfield neme= %{'depts['+# st.indext '] .deptro'}"/> 
</td 
<td> 
< s:textfield neme= W{'depts['+# st.indeset '] .dNeme'}"/> 
</td> 
<td> 
< s:textfield namer %{"'depts['+# st.indext '] .loc'}"/> 
</td> 
<to> 
< s:textfield neme= "memo"> < /s:textfield> 
</td> 
</tr> 
< /s:iterator> 
<tr> 
<td colspanr "3"> 
< s:submit> < /s:submit> 
</td> 
</tr> 
< /table> 
</s:fom> 
< /body> 
</htn> 


注意 : 在 为 Action 类 的 存放 简单 类 型 数据 的 List 属性 输入 值 时 ,textfield 的 name 
属性 直接 写成 对 应 的 Action 属性 名 即 可 ;如 果 为 Action 类 的 存放 JavaBean 类 型 的 属性 
输入 值 时 ,textfield 的 name 属性 一 定 要 写成 。 


BeanName [index] . attributeName 


例如 ,代码 11-6 中 的 depts[0]. dName、depts. [1]. dName 等 。 
图 11-1 所 示 为 addDept. jsp 在 浏览 器 中 的 输出 效果 。 
代码 11-7 为 对 应 的 结果 页 面 的 代码 。 
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国 添 加 部 门 x 
€ .30 | 127.0.0.1:85030/fulayinputLi 


部 门 编码 部 门 名 称 
Dept ae 


Per 


11-1 addDept. jsp 


代码 11-7 deptList. jsp 


< $@ page language= "java" pageFEnooding= "UTF- 8"%> 
< $8 taglib prefix= "s" uri= "/struts- tags" %> 
<html> 
<head> 
<title> 您 输入 的 部 门 是 < /title> 
< /head> 
<body> 
<table> 
<tr> 
<th> 部 门 编码 < /th> 
<th> 部 门 名 称 < /th> 
<tt> 办 公 地 点 < /th> 
<tm> 备 注 </th> 
</tr> 
< 3:iterator value= "depts" status= "st"> 
<tr> 
<to> 
< s:property value= "deptno"> < /s:property> 
</td 
<td> 
< s:property value= "dName"> < /s:property> 
</td 
<t 中 
< s:property value= "loc"> < /s:property> 
</td 
<td> 
< s:property value= "inemp[# st.index]"/> 
</td> 
</tr> 
< /s:iterator> 
< /table> 
< /body> 
< /html> 
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在 上 述 代 码 中 ,利用 Struts 2 的 iterator 标签 对 DepartmentAction 的 depts 和 memo 
进行 迭代 输出 。 注 意 , 由 于 memo 和 depts 为 两 个 不 同 的 List 对 象 , 当 使 用 同一 
iterator 迭代 时 ,一 个 List 直接 使 用 iterator 的 value 属性 控制 ,而 另 一 个 List 只 能 通过 
下 标 控 制 。 例 如 ,上 述 代码 中 的 


< s:property valuer "memo[# st.index]"/> 
利用 IteratorStatus 对 象 的 index 属性 直接 存 取 。 
使 用 数组 和 List 极其 相似 ,在 提交 页 面 上 的 写法 相同 ;在 Action 类 中 除了 声明 外 ， 


也 没有 太 大 的 区 别 ,在 此 不 再 袭 述 。 读 者 可 自行 将 上 述 例子 修改 成 数组 形式 。 
图 11-2 所 示 为 addDept. jsp 提交 后 的 结果 页 面 。 


固 怎 簿 入 的 部 门 是 
< 30C © 127.0.0.1:3080/fulu/list 


I 部 门 名 称 办 公 地 点 备 注 
Deptl Locl 。 Jemol 
Dept2 Loc2 Nem2 


图 11-2 addDept. jsp 提交 后 的 结果 页 面 
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Map 以 key/value 的 形式 存储 数据 ,和 数组 非常 相似 。 不 同 的 是 ,数组 的 下 标 为 整 型 
数据 ,而 Map 的 下 标 (Map 的 Key) 是 一 个 对 象 。 

有 时 候 , Web 应 用 程序 可 能 需要 使 用 Map 对 象 来 接收 用 户 输 入 的 数据 。 代 码 11-8 是 
在 代码 11-5 的 基础 上 修改 而 来 的 ,其 中 的 depts 属性 和 memo 属性 的 类 型 被 修改 成 了 Map。 


代码 11-8 ”DepartmentAction. java( 使 用 Map) 


Package org.chll .map.action; 

import java.util .Map; 

jimport org.dhll .mode] .Department; 

jimport om.opensyrphony .xwork?2.ActionSupport; 

Piblic class DepartmentAction extends ActionSupport { 
Private Map< String, Department> depts; 
Private Map< String, String> memo; 
// 省 略 了 dspts 和 memo 的 getter 和 setter 方 法 


Public String execute() { 
retum SUOCESS; 
3 
} 


与 使 用 数组 和 List 类 似 ,Struts 2 在 为 Map 对 象 填充 数据 时 ,如 果 发 现 Map 对 象 为 
空 ,也 会 自动 实例 化 。 
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代码 11-9 是 在 代码 11-6 的 基础 上 修改 而 来 的 。 
代码 11-9 addDept jsp( 使 用 Map) 


< $@ page language= "java" pageFnooding= "UTF- 8"%> 
< $@ taglib prefix= "s" uri= "/struts- tags" %> 
<html> 
<head> 
<title> 添 加 部 门 < /title> 
< /head> 
<body> 
< 3:fom actionr "acoDept" themer "sinplen methodF "post" narespacer "ap 
<table> 
<tr> 
<th> 部 门 编码 < /th> 
<th> 部 门 名 称 < /th> 
<th> 办 公 地 点 < /th> 
<ti> 备 。 注 </th> 
</tr> 
< s:iterator value= "new int [2]" status= "st"> 
<tr> 
<t 中 
< s:textfield name= "%{'depts['+# st.index+ '] .deptno'}"/> 
</td> 
<to 
< 3:textfield neme= "%{ "depts['+# st.indext '] .deme'}"/> 
</td> 
<t 中 
< s:textfield name= "%{'depts['+#st.indext '"].loc']"/> 
</td> 
<t 中 
< s:textfield namer "%{ meno['+# st.indext ']'}"/> 
</td> 
</tr> 
</s:iterator> 
<tr> 
<td colspan= "3> 
<s:submit> < /s:submit> 
</td> 
</tr> 
</table> 
</s:form> 
< /body> 
</htm> 


本 例 中 直接 使 用 IteratorStatus 对 象 的 index 属性 值 作为 Map 对 象 的 Key。 对 照 代 
码 代码 11-6 ,可 以 看 出 存储 JavaBean 的 List 对 象 和 Map 对 象 ,在 数据 输入 页 面 中 ,对 应 


第 11 章 类 型 转换 态 全 


的 textfield 的 name 属性 的 写法 是 一 样 的 ;但 是 存储 简单 数据 的 List 对 象 和 Map 对 象 的 
写法 是 有 区 别 的 ,为 Map 对 象 输入 值 时 .一 定 要 将 textfield 标签 的 name 属性 写成 
ActionName[key] 的 形式 。 

代码 11-10 所 示 为 addDept. jsp 对 应 的 结果 输出 页 面 。 


代码 11-10 ”ListDept. jsp( 修 改 成 Map) 


< $@ page languager "java" pagsEncodingr= "UTF- 8"%> 
< $Q taglib prefix= "s" uri= "/struts- tags" $> 
<htm> 
<head> 
<title> 您 输入 的 信息 < /title> 
< /head> 
<body> 
<table> 
<tr> 
<th> Key< /th> 
<th> 部 门 编码 < /th> 
<th> 部 门 名 称 < /th> 
<th> 办 公 地 点 < /th> 
<tm> 备 注 </th> 
</tr> 
< s:iterator value= "depts"> 
<tr> 
<to> 
< s:property value= "key"> < /s:property> 
</td> 
<to> 
< s:property value= "value.deptno"> < /s:property> 
</td> 
<t 中 
< s:property value= "value.dName"> < /s:property> 
</td> 
<td> 
< s:property value= "value.loc"> < /s:property> 
</td 
<t 中 
< s:property value= "mem[key]"/> 
</td 
</tr> 
</s:iterator> 
</table> 
< /body> 
</htnl> 


在 本 例 中 ,在 利用 iterator 控制 输出 Map 对 象 depts 的 同时 ,也 控制 了 另 一 个 Map 
对 象 memo 的 输出 ,注意 写法 的 不 同 。 读 者 也 可 以 将 该 例 与 代码 11-7 进行 比较 ,看 看 有 
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何 区别 。 

图 11-3 所 示 为 deptList. jsp 在 浏览 器 中 的 输出 。 其 中 ,addDept. jsp 中 输入 的 各 数 
据 与 图 11-1 中 是 一 样 的 。 请 读者 将 图 11-2 与 图 11-3 进行 比较 ,看 看 输出 的 次 序 有 何 
不 同 。 


国 你 输入 的 信息 x 到 
€ 3 ©|© 127.0.0.1:8080/fulu/nap/addDept.: 窑 |™ 


key 部 门 编码 部 门 名 称 办 公 地 点 备 注 
1 2 Dept2 Loc2 。 Wemo2 
ol Deptl Locl emol 


图 11-3 deptList. jsp 在 浏览 器 中 的 输出 


11.3 自 定义 类 型 转换 器 


11.31 开发 自 定义 类 型 转换 器 


有 时 候 ,Struts 2 自 带 的 类 型 转换 器 可 能 无 法 满足 应 用 的 需求 ,例如 它 无 法 将 货币 
兰 12,365,487. 00 转换 成 java. lang. Number 或 其 他 数值 型 类 型 ,也 无 法 将 空间 坐标 (x， 
y,z) 转 换 成 某 种 合适 的 Java 数据 类 型 。 这 时 ,程序 员 必 须 开发 自己 的 类 型 转换 器 。 

自 定义 类 型 转换 器 ,需要 实现 ognl. TypeConvert 接口 ,也 可 以 扩展 该 接口 的 实现 类 
DefaultTypeConverter 或 者 StrutsTypeConverter。 

ognl. TypeConvert 接口 只 有 一 个 方法 ,原型 如 下 : 

Public Cbject convertValue Map< String, Object> omtext, Cbject target, 

Maber merber, String propertyName, Chject value,Class toType) 

其 中 ,各 参数 说 明 如 下 。 

(1) context: 将 在 其 中 进行 类 型 转换 的 上 下 文 环境 。 通 过 该 参数 ,程序 员 可 以 访问 
Value Stack 中 的 资源 。 

(2) target: 将 在 其 中 对 属性 设置 的 目标 对 象 。 

(3) member: 将 被 设置 的 类 成 员 、 构 造 函 数 或 属性 。 

(4) propertyName: 将 被 设置 的 属性 名 。 

(5) value: 将 被 转换 的 值 。 

(6) toType: 将 被 转换 成 的 目标 类 型 。 

DefaultTypeConverter 类 实现 了 TypeConvert 接口 ,并 提供 了 convertValue( ) 方 法 
的 简化 版 本 。 

Public Cbject convertValue Map< String, Object> omtext, Object value, 

Class toType) 


代码 11-11 实现 了 将 形 如 “ 竺 12,365 ,487. 00” 的 字符 串 与 Double 类 型 之 间 的 转换 。 
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代码 11-11 CurrencyConverter. java 


Public abject convertValue (Map oontext, Cbject value，Class toType) { 

if(toIype== double.class){ // 由 string 类 型 转换 成 double 类 型 
String[] s= (String[])value; 
String ww s[0] .substring (1); 
Vv.replace(,", ™); 
retum Double.parseDouble (Vv); 

} 

else if (torype== String.class) { // 由 double 类 型 转换 成 string 类 型 
NunberFormat fint= new DecimalFormat (" 壮 # ,##0.00"); 
retum ft.format (value); 

} 

retum null; 


} 


利用 CurrencyConverter 转换 器 ,可 以 将 客户 端 提交 的 字符 串 " 半 12,365,487. 00" 转 
换 成 Double 类 型 数据 12365487. 00; 并 且 当 向 客户 端 输出 Double 型 数据 时 ， 
CurrenyConverter 转换 器 将 再 次 启用 ,将 12365487. 00 转换 成 " 半 12,365 ,487. 00"。 

通过 代码 11-11 可 以 看 出 ,一 个 转换 器 至 少 应 该 实现 两 种 类 型 的 转换 ,一 种 是 由 
String 类 型 转换 成 指定 数据 类 型 ; 另 一 种 是 由 指定 数据 类 型 转换 成 String 类 型 。 

注意 : 在 将 客户 端 提交 数据 由 String 类 型 转换 成 指定 数据 类 型 时 ,需要 将 参数 value 
转换 成 String 数组 。 原 因 是 Struts 2 在 获取 请 求 参数 时 利用 HttpServletRequest 的 
getParameterMap() 方 法 ,该 方法 返回 的 Map 对 象 的 value 是 一 个 String 数组 。 

Struts 2 提供 了 一 个 抽象 类 org. apache. Struts 2. model. StrutsTypeConverter, 该 类 
是 从 ognl. DefaultTypeConverter 扩展 而 来 。StrutsTypeConverter 具有 两 个 抽象 方法 ， 
用 于 实现 String 和 其 他 数据 类 型 之 间 的 转换 。 

(1) public abstract Object convertFromString(Map context, String[ | values, Class 
toClass) : 该 方法 用 于 将 一 个 或 多 个 String 转换 成 指定 数据 类 型 。 参 数 context 表示 转 
换 时 所 处 的 上 下 文 的 Map 对 象 , 参 数 values 是 要 转换 的 字符 串 ,参数 toClass 为 要 转换 
的 目标 类 型 。 

(2) public abstract String convertToString(Map context, Object o) : 该 方法 用 于 将 
指定 数据 类 型 转换 成 String 类 型 。 参 数 context 表示 转换 时 所 处 的 上 下 文 的 Map 对 象 ， 
参数 o 是 要 转换 的 对 象 。 

下 面 编写 一 个 用 于 处 理 复数 的 程序 。 当 客户 端 提 交 一 个 复数 形式 的 字符 串 时 ,转换 
器 能 够 将 其 自动 换 成 复数 形式 ; 当 服 务 器 向 客户 端 输出 一 个 复数 时 ,转换 器 能 够 将 其 转 
换 成 字符 串 形式 。 
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代码 11-12 所 示 为 一 个 复数 类 Complex。 


代码 11-12 ”Complex 类 


package org.chll model; 
Puiblic class Carplex { 


» 


private float realPart; 
private float imagPart; 
// 省 略 了 realPart 和 imagPart 的 getter 和 setter 方 法 


Public String tostring() { 
String omplex; 
if (realPart!= 0g&imagPart> 0) // 实 部 不 为 0, 并 且 虚 部 大 于 0 
Compless= realPart+ "+ "+ jmagPart+ "i";» 
else 
{if (realPart!= 0g&imagPart< 0) // 实 部 不 为 0, 并 且 虚 部 小 于 0 
omplex= realPart+ "+ imagPart+ "i"; 
else 
if(imagPart==0) // 虚 部 等 于 0 
Cmplex= realPart+ ""7 
else // 实 部 等 于 0 
Complex= imagPart+ "i"; 
retum omplex; 


代码 11-13 定义 了 一 个 ComplexAction 类 ,该 类 包含 三 个 Complex 类 型 的 属性 cl、 
c2 和 result。execute() 方 法 实现 了 两 个 Complex 类 型 数据 的 加 法 。 


代码 11-13 ComplexAction. java 


Package org.chll .action; 


jimport java.model .Map; 

import org.chl1.mpdel.Complexy 

jimport om.opensyrphony .xwork2.ActionContext; 
jimport om.opensynrphony .xwork?2.ActionSupport; 


Public class CamplexAction extends ActionSupport { 


Private Conplex cl; 

private Complex c2; 

Private Complex result; 

// 省 略 了 cl.c2 和 result 的 getter 和 setter 方 法 
Public String execute () throws Exception { 


Tesult= new Complex() 7 
Tesult.setJImagPart (cl1.getImagPart()+ c2.getImagPart())7 


TIesult.setRealPart (cl.getRealPart ()+ c2.getRealPart ()); 
retum SUOCESS; 


代码 11-14 给 出 了 用 于 测试 ComplexAction 类 的 页 面 complex. jsp。 该 页 面 既 是 用 
户 输入 两 个 复数 的 页 面 ,也 是 ComplexAction 类 的 结果 页 面 。 


代码 11-14 complex. jsp 


< $@ page language= "java" pageEnooding= "UTE- 8"%> 
< $8 taglib uri= "/struts- tags" prefix= "s" %> 
<html> 
<head> <title> 复 数 < /title>< /head> 
<body> 
<s:form acticon= "add.action"> 
< s:textfield neme= "cl" 1abel= "复数 1">< /s:textfield> 
< s:textfield namer "c2" label= "复数 2"> < /s:textfield> 
<s:submit> < /s:sutmit> 
</s:fom> 
结果 :< s:property value= "result"/><br/> 
< /body> 
< /himl> 


代码 11-15 为 Complex 类 型 和 字符 串 之 间 的 转换 器 类 ComplexConverter。 该 类 扩 
展 自 StrutsTypeConverter。 


代码 11-15 ComplexConverter. java 


Package org.chll .converter; 


jimport java.model .Map; 
import org.apache.struts?.model .StrutsTypeConverter; 
jimport org.dhll .model .Canplex; 
Public class ComplexConverter extends StrutsTypeConverter { 
/将 客户 端 输 入 的 字符 串 转换 成 cmplex 类 型 
Public abject convertFramString (Map context，String[] o,Class toclass){ 


Complex c= new Complex()7 
String s=o[0]; 
int index= 5.lastIndexOf (i'); // 获 得 虚 部 i 的 位 置 
if(index==- 1){ //s 为 实数 
Cc.setRealPart (Float .parseFloat (s)) 7 
Cc.setImagPart (0); 
} 
else //s 为 虚数 
int i; 
for(i= s.length()- 2;i>=0;i-—) // 查 找 虚 部 的 符号 位 置 
if(s.charat (i)=="- "||s.charat (i)== "+ ') 
break; 
if(i==-]) // 纯 虚数 , 且 虚 部 为 正 数 
0; 


String img= s.substring (i, index); 
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Cc.setTImagPart (Float .parseFloat (img) ) 7 


if(i!=0) // 实 部 和 虚 部 均 不 为 0 
c.setRealPart (Float .parseFloat (s.substring (0,i))); 
else // 纯 虚数 


c.setRealPart (0); 
} 
retum c; 
} 
// 将 cmplex 类 型 转换 成 字符 串 类 型 
public String convertToString Map context, Cbject o) { 
Camplex c= (Cmplex)o; 
Teturn c.toString(); 


11.32 配置 类 型 转换 器 

在 编写 完 自 定义 的 类 型 转换 器 之 后 ,还 要 将 该 类 型 转换 器 进行 配置 ,才能 在 Web 应 
用 程序 中 使 用 。 程 序 员 根据 需要 ,可 以 将 类 型 转换 器 配置 成 局 部 类 型 转换 器 和 全 局 类 型 
转换 器 两 种 。 

1 局 部 类 型 转换 器 

局 部 类 型 转换 器 需要 为 Action 的 每 一 个 属性 分 别 指定 类 型 转换 器 。 局 部 类 型 转换 
器 需要 提供 如 下 格式 的 文件 。 

RcticnName- oonversion.properties 

其 中 ,ActionName 为 Action 类 的 名 字 。 该 Action 类 的 某 个 或 某 些 属性 需要 利用 自 
定义 类 型 转换 器 进行 类 型 转换 。-conversion. properties 是 固定 不 变 的 格式 。 

类 型 转换 配置 文件 是 一 个 典型 的 属性 文件 ,该 文件 内 容 的 形式 如 下 : 

fieldl= custamConverterl 

field2= custamConverter2 

例如 ,为 上 面 的 ComplexAction 类 提供 的 类 型 转换 配置 文件 的 名 字 为 ComplexAction- 
conversion. properties ,其 内 容 如 代码 11-16 所 示 。 


代码 11-16 ComplexAction-conversion. properties 


Cl= org.chl1.converter.ComplexConverter 
result= arg.chl1.converter.ComplexConverter 


上 述 配置 文件 分 别 为 ComplexAction 类 的 属性 cl、c2 和 result 配置 了 自 定义 类 型 转 
换 器 。 
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最 后 ,需要 提醒 大 家 的 是 ,该 类 型 转换 配置 文件 一 定 要 和 Action 类 放 到 同一 个 子 目 
录 中 。 

2 配置 全 局 类 型 转换 器 

局 部 类 型 转换 器 仅 对 某 个 Action 类 中 的 属性 有 效 , 如 果 所 有 Action 类 的 特定 类 型 
的 属性 都 具备 相同 的 类 型 转换 方式 ,可 以 为 该 类 型 配置 全 局 的 类 型 转换 器 。 全 局 类 型 转 
换 器 的 名 字 为 xwork-conversion. properties, 位 于 Web 应 用 程序 的 WEB-INF/classes/ 
子 目 录 (MyEclipse 工程 的 src 目录 ) 下 ,文件 内 容 如 下 : 


fullyQualifiedclassNamel= CustamerConverterl 


例如 ,为 前 面 定义 的 Complex 类 型 数据 定义 的 全 局 类 型 转换 配置 文件 如 代码 11-17 
所 示 。 


代码 11-17 xwork-conversion. properties 


org.chl1.mpdel.Complex= org.chl1.converter.ComplexConverter 


此 时 ,无 论 在 工程 的 哪个 类 中 用 到 Complex 类 型 的 数据 ,都 将 使 用 ComplexConverter 
转换 器 进行 类 型 转换 。 
在 浏览 器 中 浏览 complex. jsp ,运行 结果 如 图 11-4 所 示 。 


国 复数 x 
€ 30 ©127.0.0.1:3080/fulu/add acti 


复数 1: 1123056.81 
复数 2: |260+74.0; 


Submt 


结果 :97. 0+17.23 


图 11-4 复数 类 型 的 转换 


114 类 型 转换 中 的 错误 处 理 


用 户 在 填写 表单 中 的 数据 时 ,经 常会 输入 一 些 格式 不 正确 的 数据 。 例 如 ,在 图 11-4 
所 示 的 页 面 中 ,将 复数 1 的 值 输入 为 “123. 0 一 56. 8i”。 当 输入 数据 格式 不 正确 时 ,在 类 型 
转换 过 程 中 会 导致 错误 的 发 生 。Conversion Error 拦截 器 将 产生 错误 的 字段 和 错误 信息 
放 到 ActionContext 中 名 为 conversionErrors 的 Map 对 象 中 , 当 表单 和 发 生 错误 的 字段 
采用 的 不 是 simple 主题 时 ,该 字段 将 输出 一 条 field 级 错误 信息 。 

Irvalid field value for field "c2" 

这 里 ,c2 为 产生 错误 的 字段 名 。 


上 述 错误 提示 是 xwork 默认 的 输入 错误 消息 ,定义 在 xwork-messages. properties 
文件 中 。 如 果 希 望 为 用 户 提供 一 条 中 文 的 错误 消息 提示 ,可 以 为 应 用 程序 配置 一 个 资源 
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文件 ,并 配置 如 下 资源 信息 。 
xwork.default .invalid.fieldvalue= 数 据 类 型 不 合法 


具体 配置 方法 可 以 参见 第 10 章 国 际 化 资源 文件 的 配置 部 分 。 

一 旦 资源 xwork. default. invalid. fieldvalue 被 覆盖 ,应 用 程序 中 的 所 有 类 型 转换 的 
错误 提示 都 将 变 成 “数据 类 型 不 合法 ”。 如 果 和 希望 为 不 同 的 字段 提供 不 同 的 错误 提示 ,可 
以 为 Action 类 提供 一 个 Action 范围 的 资源 文件 ,并 编写 如 下 格式 的 资源 消息 。 


invalid. fieldvalue.fieldname— message 
其 中 ,invalid. fieldvalue 是 固定 的 写法 ;fieldname 是 需要 定制 错误 消息 的 Action 类 


的 属性 ;message 为 错误 提示 消息 。 
代码 11-18 给 出 了 为 ComplexAction 类 的 cl 和 c2 属性 定制 错误 消息 的 资源 文件 。 


代码 11-18 ComplexAction. properties 


invalid.fieldvalue.cl=cl 不 是 有 效 的 复数 ! 
invalid.fieldvalue.c2= c2 不 是 有 效 的 复数 ! 


除了 可 以 定制 错误 消息 的 文字 外 ,还 可 以 定制 错误 消息 的 CSS 样式 。JSP 在 输出 错 
误 消 息 时 ,会 将 错误 消息 放 在 一 个 HTML 的 span 标签 
中 ,并 将 它 的 class 属性 指定 为 errorMessage。 因 此 , 程 人 
序 员 可 以 通过 覆盖 errorMessage 来 改变 错误 消息 的 输 数据 关 型 丰 合法 


出 样式 。 例 如 ,下 面 的 代码 将 错误 信息 的 颜色 设置 为 让 
红色 。 : [e07400 
< style typer "text/caamy 
.errorMessage{color:red} 
Se 图 11-5 显示 定制 了 错误 的 
图 11-5 给 出 的 complex. jsp 显示 了 定制 后 的 错误 complex. jsp 


提示 。 
同步 训练 
1. 编写 Web 程序 ,实现 格式 为 (x,y,z) 形 式 的 空间 坐标 的 输入 。 编 写 空 间 坐 标 类 、 


坐标 类 型 转换 器 ,转换 配置 文件 以 及 相应 的 Action 类 和 输入 /输出 页 面 。 
2. 编写 Web 程序 ,实现 一 组 空间 坐标 的 输入 ,要求 分 别 使 用 List 和 Set 实现 。 
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121 注解 概述 


在 前 面 的 章节 中 ,通常 在 struts. xml 中 进行 应 用 程序 的 配置 。 事 实 上 ,Struts 2 还 提 
供 了 一 种 称 为 注解 (Annotation) 的 技术 ,允许 程序 员 在 不 使 用 struts. xml 的 情况 下 , 完 
成 对 Action 、 Result package 和 拦截 器 等 的 配置 。 

从 Struts 2. 1 版 本 开始 ,Struts 2 使 用 新 的 注解 插件 convention-plugin 代替 了 以 往 
的 codebehind-plugin。 与 codebehind-plugin 相 比 ,convention-plugin 有 如 下 特点 。 

(1) 通过 包 命 名 习惯 来 确定 Action 的 位 置 。 

(2) 用 命名 习惯 来 确定 Result( 支 持 JSP、FreeMarker 等 ) 映 射 路 径 。 

(3) 通过 类 名 约定 结果 视图 的 URL。 

(4) 通过 包 名 约定 命名 空间 的 名 称 。 

(5) 采用 遵循 SEO 规范 的 链接 地 址 ,例如 用 hello-action 替代 HelloAction。 

(6) 使 用 注解 配置 Action 的 名 字 。 

(7) 使 用 注解 配置 Action 的 拦截 器 。 

(8) 使 用 注解 配置 命名 空间 。 

(9) 使 用 注解 配置 XWork 包 。 

(10) 提供 默认 Action 以 及 默认 的 结果 。 例 如 ,对 于 客户 请 求 /products,convention- 
plugin 尝试 寻找 com. example. actions. Products 或 com. example. actions. products. 
Index 进行 处 理 。 

convention-plugin 插件 允许 在 程序 员 没 有 进行 任何 配置 的 情况 下 ,通过 约定 完成 自 
动 配置 。 

如 果 要 利用 convention-plugin 注解 插件 完成 应 用 程序 的 配置 ,首先 应 该 确保 将 以 下 
三 个 架 包 引入 到 工程 中 。 

asm- x.X.jar 

asm- commcns- x.x.jar 

struts 2- convention— Plugin- wex.jar 

这 三 个 jar 文件 可 以 从 Struts 2 下 载 包 中 找到 。 

需要 注意 的 是 ,使 用 convention-plugin 对 应 用 程序 的 行为 进行 注解 ,并 不 能 完全 抛 
弃 struts. xml。 注 解 只 是 减少 了 程序 员 在 struts. xml 中 进行 与 Action Result 和 拦截 器 
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有 关 的 配置 。 
122 约定 


假设 在 Web 应 用 程序 的 WEB-INF/content 目录 下 存放 着 一 个 hello. jsp 页 面 , 当 通 
过 浏览 器 访问 http://localhost:8080/hello 或 http://localhost:8080/hello. action 时 ,能 
够 看 到 浏览 器 中 显示 出 hello. jsp 的 内 容 。 令 人 惊讶 的 是 用 户 根 本 就 没有 编写 hello. 
action 对 应 的 Action 类 。 所 有 这 些 工作 都 是 由 convention-plugin 自动 完成 的 。 
下 面 介绍 convention-plugin 上 默认 时 使 用 的 一 些 约定 。 


1 结果 视图 存储 路 径 的 约定 

默认 时 ,convention-plugin 假设 所 有 的 结果 页 面 存放 在 WEB-INF/content 目录 下 。 

如 果 用 户 希 望 修改 结果 页 面 存放 目录 ,可 以 在 struts. xml 或 struts. properties 中 重 
新 配置 。 例 如 ,在 struts. xml 配置 


< constant name= "struts.oonvention.result .path" value= "/WEB- INF/jsp" /> 
所 有 结果 页 面 的 存放 路 径 将 被 修改 为 /WEB-INF/page。 


2 Acio 类 存放 路 径 的 约定 

convention-plugin 是 如 何 找到 Web 应 用 程序 中 的 Action 类 的 呢 ? 在 默认 时 ,所 有 
名 称 中 具有 action ,actions struts 和 Struts 2 的 包 都 会 被 convention-plugin 作为 含有 
Action 类 的 路 径 来 搜索 。 在 这 些 包 的 路 径 下 ,所 有 com. opensymphony. xwork2. Action 
的 实现 类 以 及 以 名 字 使 用 Action 结尾 的 类 都 是 convention-plugin 所 要 处 理 的 
Action 类 。 

如 果 用 户 希 望 自 定义 convention-plugin 搜索 的 包 名 ,可 以 在 struts. properties 或 
struts. xml 中 修改 struts. convention. package. locators 属性 。 例 如 : 


< constant name= "struts.oonvention.package.locators" value= "Action,Actions" /> 
这 时 convention-plugin 只 在 名 称 含有 Action 和 Actions 的 包 中 搜索 Action 类 。 


3 命名 空间 的 约定 

convention-plugin 约定 ,从 定义 的 package. locators 开始 到 包 结 束 的 部 分 ,就 是 命名 
空间 。 例 如 : 

(1) com. example. actions. MainAction 的 命名 空间 为 “/”。 

(2) com. example. actions. products. Display 的 命名 空间 为 /products。 

(3) com. example. struts. company. details. ShowCompanyDetailsAction 的 命名 空 
间 为 /company/details。 

convention-plugin 利用 类 名 确定 资源 的 URL。 首 先 , 它 将 类 名 中 的 Action 去 掉 ;如 
果 发 现 类 名 采用 的 是 驼峰 式 的 命名 规则 (英文 单词 首 字 母 大 写 ) ,会 将 所 有 驼峰 字母 转换 
成 小 写 , 并 使 用 “-” 连 接 。 例 如 : 

(1) com. example. actions. MainAction 对 应 的 URL 为 /main。 
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(2) com. example. actions. products. Display 对 应 的 URL 为 /products/display。 

(3) com. example. struts. company. details. ShowCompanyDetailsAction 对 应 的 
URL 为 /company/details/show-company-details。 

注意 : com. example. actions. helloWorldAction 对 应 的 URL 为 /helloWorld, 而 不 是 
hello-world 。 


4 FEsut 和 Resuts 的 约定 

convention-plugin 约定 如 下 。 

(1) 当 要 访问 的 资源 没有 对 应 的 Action 存在 ,访问 资源 的 名 称 就 直接 和 页 面 的 名 称 
对 应 。 必 须要 注意 的 是 ,访问 时 用 到 的 资源 名 称 和 页 面 的 名 字 必 须 是 小 写 的 。 这 就 是 为 
什么 在 前 面 的 例子 中 ,在 没有 进行 任何 配置 的 情况 下 ,用户 也 能 访问 到 hello. jsp 页 面 。 

(2) 在 存在 对 应 的 Action 的 情况 下 ,优先 使 用 "Action 的 URL 十 Result 的 字符 串 十 
文件 类 型 的 后 级 ”的 方式 查找 对 应 的 结果 页 面 。 当 没有 找到 时 ,将 按照 *Action 的 URL 
十 文件 类 型 的 后 级 ”重新 查找 。 

表 12-1 中 给 出 了 几 个 result 结果 映射 的 示例 。 


表 12-1 result 结果 映射 的 示例 


URL Result 能 够 匹配 的 文件 Result 类 型 
/hello success | /WEB-INF/content/hello. jsp Dispatcher 
/hello success | /WEB-INF/content/hello-success. htm Dispatcher 
/hello success | /WEB-INF/content/hello. ftl FreeMarker 
/hello-world input /WEB-INF/content/hello-world-input. vm Velocity 
/test] /test2/hello error /WEB-INF/content/test/test2/hello-error. html Dispatcher 

5 Acion 链 的 约定 


如 果 一 个 Action 返回 的 结果 码 是 同一 个 package 内 另外 一 个 Action 的 名 字 ,并且 
第 一 个 Action 返回 的 result 没有 对 应 的 页 面 存在 ,这 两 个 Action 将 形成 一 个 Action 链 。 
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1231 @Acion 和 @Acions 


Convention 除了 约定 利用 类 名 确定 资源 的 URL 外 ,还 提供 了 一 种 名 为 @Action 的 
注解 ,允许 用 户 将 Action 类 映射 成 其 他 的 URL。@Action 注解 包含 以 下 属性 。 

(1) value: 指定 所 要 映射 的 URL 的 名 称 。 

(2) params: 指定 需要 注入 Action 的 参数 。 

(3) results: 指定 结果 视图 。 

(4) interceptorRefs: 指定 拦截 器 引用 。 

(5) excepitonMappings: 声明 错误 处 理 。 

params 属性 的 格式 如 下 : 
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params={ 只 数 1", "第 1 个 参数 的 值 ", "参数 2", "第 2 个 参数 的 值 ",.… "参数 mm，" 第 na 个 参数 的 

值 "} 

当 需 要 将 同一 个 Action 类 映射 为 多 个 URL 时 ,需要 将 这 些 @ Action 放 到 一 个 @ 
Actions 中 。 

来 看 一 个 例子 ,如 代码 12-1 所 示 。 


代码 12-1 @Action 注解 


import om. opensynphony.xwork?2.ActionSupport; 


piblic class actionAnno extends ActionSupport { 
Private int param; 
Private String message; 
// 省 略 了 gat 和 set 方 法 


8Rcticn (value= "/acticn2", 
Faramo= {"parem", "100", "message", "hello wolrd!"} 
) 
Public String execute () { 
retum SUOCESS; 


上 述 代 码 通 过 @Actions 和 @Action 将 actionAnno 类 的 execute() 方 法 的 URL 分 
别 映射 成 /actionl 和 /action2 ,并 为 参数 param 和 message 注入 不 同 的 值 。Good() 方 法 
的 URL 地 址 是 不 推荐 的 ,上 面 url 将 使 用 java 包 名 作为 namespace, 而 不 会 直接 使 用 
Action 注解 的 地 址 。 

注意 : 

(1) 一 般 情况 下 , 尽 可 能 不 将 同一 个 Action 类 映射 成 不 同 的 URL, 以 免 发 生 混淆 。 

(2) 一 旦 某 个 Action 类 使 用 了 @Action 注解 ,原来 利用 类 名 约定 资源 的 URL 将 不 
再 对 该 类 有 效 , 以 下 其 他 注解 也 是 同样 的 。 例 如 ,上 例 中 已 经 不 能 再 利用 /actionAnno 去 
访问 该 Action 类 了 。 
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1232 @Resut 和 @Resuts 


Convention plugin 允许 将 Action 的 结果 映射 到 约定 之 外 的 其 他 视图 上 。 

在 Action 类 层面 上 定义 的 @Result 和 @Results 是 全 局 的 注解 ,将 被 该 Action 类 中 
定义 的 所 有 Action 所 共享 。 在 method 层面 上 定义 的 @Result 和 @Results 是 局 部 的 注 
解 , 仅 应 用 于 当前 的 method。 当 全 局 注解 和 局 部 注解 冲突 时 ,起 作用 的 是 局 部 注解 。 

@Result 注解 用 于 声明 一 个 结果 ,有 以 下 属性 。 

(1) name: 指定 结果 的 名 字 ,默认 为 success。 

(2) type: 指定 结果 的 类 型 ,默认 为 在 二 resultrtypes 二 中 定义 的 默认 类 型 。 

(3) location: 指定 结果 的 页 面 位 置 。 

(4) params: 指定 结果 的 可 选 参数 。 

当 一 个 Action 有 多 个 结果 视图 页 面 时 ,需要 利用 @Results 注解 将 多 个 @Result 组 
合 起 来 。@Results 只 有 一 个 属性 value, 其 值 为 一 个 @Result 数组 。 

下 面 介 绍 一 个 在 Action 类 中 使 用 @Result 和 G@ Results 注解 的 例子 ,如 代码 12-2 
所 示 。 


代码 12-2”@Result 和 @Results 注解 


Package om.z2ero.action; 
jimport org.apache.struts2.coonvention.annotation.* ? 
jimport om.opensyrphony .xwork?2.ActionSupport; 


Public class resultAnno extends ActionSupport { 
Private int param; 
Private String color; 
/* 省略 了 get 和 set 方 法 * / 


Q@Rcticn (value= "/result", 
results= { 
@ Result (locaticnr "hello.jsp"), 
@ Result (neme= "input", 
looaticre "hello- irput .jsp", type= "redirect")} 
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piblic String good() { 
System.out .print in ("dp something") ; 
retum SUOCESS; 


} 


假设 在 修改 struts. convention. result. path 的 情况 下 : 

(1) 访问 http://127. 0. 0. 1: 8080/zero/result? param 一 1, 将 转 到 /WEB-INF/ 
content/hello. jsp 页 面 。 

(2) 访问 http://127. 0. 0. 1:8080/zero/result?param 二 2, 将 转 到 /index. jsp 页 面 。 
注意 , 当 @Result 的 type 被 指定 为 redirect” 时 ,location 中 的 结果 视图 将 不 再 默认 为 相 
对 于 struts. convention. result. path 所 设置 的 目录 ,而 是 相对 于 应 用 程序 的 根 目录 。 

(3) 访问 http://127. 0. 0. 1:8080/zero/result! good?param 王 3, 结果 视图 将 变 为 / 
WEB-INF/content/error. jsp。 


1233 @Namespace 


如 果 不 希 望 Convention plugin 使 用 约定 的 包 名 作为 命名 空间 ,可 以 使 用 @ 
Namesapce 注解 修改 Action 类 的 namespace。@Namesapce 注解 可 以 放 在 Action 类 中 ， 
或 者 是 放 在 一 个 独立 的 名 为 package-info. java 的 文件 中 。 在 Action 中 编写 的 @ 
Namespace 注解 会 作用 在 该 Action 中 所 有 的 相对 URL 上 。 在 package-info. java 文件 
中 编写 的 @ Namespace 注解 会 作用 在 位 于 该 包 中 的 所 有 的 Action( 不 包括 子 包 中 的 
Action) 。 

@Namespace 注解 只 有 value 属性 ,用 来 指明 包 命名 空间 。 

下 面 介 绍 一 个 在 Action 类 中 使 用 @Namespace 注解 的 例子 ,如 代码 12-3 所 示 。 


代码 12-3”@Namespace 注解 


jimport org.apache.struts2.conventicn.annotaticn.x ; 
jimport ccm.apensymphony.xwork2.RMcticnSupport7 


Public String good() { 
System.out.println ("db samething"); 
Teturn SUOCESS; 
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上 例 中 可 以 使 用 /cutom/hello 和 /sub/hello 两 个 不 同 的 URL 去 访问 Action。 
接 下 来 介绍 如 何在 package-info. java 中 配置 @Namespace 注解 ,如 代码 12-4 所 示 。 
代码 12-4 ”在 package-info. java 中 配置 @Namespace 注解 


@ org.apache. struts2.convention.annotation.Namespace ("/custam") 
Package om.2ero.actions; 


这 样 , 包 package com. zero. actions 中 所 有 Action 的 默认 命名 空间 被 修改 成 /custom。 

@Namesapce 注解 用 于 更 改 Action 类 的 namespace。 这 个 注释 用 于 一 个 Action 类 
或 者 用 于 package-info. java。 当 用 于 Action 类 ,将 影响 该 类 中 定义 的 所 有 Action; 当 用 
于 package-info. java, 将 影响 该 包 中 所 有 的 Action ,但 不 影响 该 包 的 子 包 中 的 Action。 
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@ResultPath 注解 用 来 改变 结果 页 面 所 在 的 目录 ,参见 代码 12-5。 
代码 12-5 @ResultPath 注解 


Package cm.zero.action; 

import org.apache.struts2.convention.annotation. * ; 
jimport om.cpensyrphony .xwork2.ActionSupport; 

@ ResultPath ("/WEB- INF/page") 

Public class resultPathAnno extends ActionSupport { 


Public String execute () { 
retum SUOCESS; 
} 


@ Action ("myurl") 

Public String good() { 
System.cut.println ("dp samething"); 
retum SUOCESS; 
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@ParentPackage 注解 用 来 为 Action 指定 父 包 , 它 只 有 一 个 value 属性 ,用 来 指定 父 
包 的 名 字 。 
下 面 介 绍 一 个 在 Action 类 中 使 用 @ParentPackage 注解 的 例子 ,如 代码 12-6 所 示 。 


代码 12-6”@ParentPackage 注解 


package ccm.zero.actionsy 
jimport om.cpensynphony .xwork?.ActionSupport; 
import org.apache.struts?.0oonvention.annotation.Action; 
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import org.apache.struts2.conventicn.annotation.ParentPackage; 


@ FarentPackage ("custar¥WorkPackage") 
Puiblic class packagenction extends ActionSupport { 
Public String execute() { 
Ietum SUOCESS; 
} 
} 


如 果 和 希望 为 所 有 的 Action 指定 父 包 ,可 以 在 struts. xml 中 修改 属性 struts. 


convention. default. parent. package 的 值 。 
1 人 236 @lInterceplorRsf 和 @ InterceptorRefs 注解 


@Interceptor 注解 用 来 为 Action 引用 拦截 器 , 它 只 有 一 个 value 属性 ,用 来 指定 引 
用 的 拦截 器 或 拦截 器 栈 的 名 字 。 

当 需 要 为 Action 配置 多 个 @Interceptor 注解 时 ,可 以 将 这 些 @Interceptor 注解 组 成 
一 个 数组 ,然后 赋值 给 @InterceptorRefs 注解 的 value 属性 。 

下 面 介绍 一 个 在 Action 类 中 使 用 @ InterceptorRef 和 @ InterceptorRefs 注解 的 例 
子 , 如 代码 12-7 所 示 。 


代码 12-7 @InterceptorRef 和 @InterceptorRefs 注解 


Package om.zero.action; 
jimport org.apache.struts2.oonvention.annotation.* ? 
jimport ccm.cpensyrphony.xwork2.RMcticnSupport7 


Eublic class intercepterRnnp extends ActionSupport { 
@ Action (value= "ip", interosptorRefs=@ InterceptorRef ("validaticn") 
,results= {@ Result (name= "login", location= "/login.jsp") 
1@ Result (name= "sucoess", location= "/index.jsp") 


人 37 @BcepionVepping 和 @ BcepionVeppings 注解 
@ExceptionMapping 注解 用 来 为 Action 配置 异常 处 理 。 与 @result 注解 类 似 , 该 注 
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解 也 可 以 使 用 params 属性 配置 要 传人 的 参数 。 另 外 ,该 注解 可 以 为 整个 Action 类 配置 
配置 异常 处 理 , 也 可 以 为 某 一 个 method 配置 异常 处 理 。 

@ExceptionMapping 注解 有 以 下 属性 。 

(1) exception: 用 于 指定 需要 捕获 的 异常 。 

(2) result: 用 于 指定 捕获 异常 之 后 跳 转 到 的 结果 视图 。 

(3) params: 用 于 指定 参数 列表 。 

当 需 要 声明 多 个 错误 处 理 时 ,必须 为 这 些 错 误 分 别 编 写 @ExceptionMapping 注解 ， 
然后 将 其 组 成 数组 , 放 到 一 个 @ExceptionMappings 注解 中 。 

下 面 介绍 一 个 在 Action 类 中 使 用 @ExceptionMapping 和 @ExceptionMappings 注 
解 的 例子 ,如 代码 12-8 所 示 。 


代码 12-8 ”@ExceptionMapping 和 @ExceptionMappings 注解 


QExoeptiorMeppings ({ 
QExoeptionMepping( 
exoeptione "java. lang.NullPointerExosption" 
:result= "success" 
Params= {"pareml", "vall"}) 
D) 
Public class ExosptionsActionLevelAction { 
Public String execute () throws Exosption { 
retum null; 
} 


124 案例 8: 利用 注解 配置 留言 板 程序 


本 节 通 过 实例 介绍 如 何 利 用 注解 取代 struts. xml 中 与 Action 配置 .Result 映射 和 
拦截 器 等 有 关 的 配置 。 


1 准备 工作 

首先 ,在 MyEclipse 集成 环境 中 新 建 一 个 Web Project 工程 , 取 名 为 zNotes。 接 下 
来 ,将 留言 板 程序 工程 中 的 源码 、 静 态 资源 (页 面 、 图 片 和 样式 表 等 )、web. xml 和 jar 库 复 
制 到 zNotes 工程 中 。 在 实际 操作 时 ,可 以 直接 将 src 目录 和 WEB-INF 目录 及 其 他 资源 
目录 直接 复制 到 zNotes 中 。 

将 asm-x. x. jar、asm-commons-x. x. jar 和 Struts 2-convention-plugin-xxx. jar 引入 
工程 。 

2 配置 srusxnl 

使 用 注解 配置 应 用 程序 并 不 能 完全 取代 struts. xml, 一 些 常 量 的 配置 和 拦截 器 的 配 
置 仍然 需要 在 struts. xml 中 完成 。 修 改 zNotes 的 struts. ml, 如 代码 12-9 所 示 。 
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代码 12-9 struts. xml 


< 2ml versior= "1.0" encoding= "UIF- 8" 2> 

< IDOCTYPE struts PUBLIC 
™ /apache Software Foundation//DID Struts Configuraticn 2.0//EN" 
"http://struts.apadhe.org/dtds/struts- 2.0.dtd"> 

<struts> 

< constant neme= "struts.convention.result .path" value= "/WEB- INF/jsp"/> 


<Fackace namer "zeror- notes" namespace= "/" extends= "corwenticnr defoult"> 
< interosptors> 
< interceptor name= "security" 
class= "notes. interoeptor.AuthenInterosptor"> < /interceptor> 
< interosptor— stack name= "auth"> 
< nterceptor- ref name= "defaultStack"> < /interceptor- ref> 
< interceptor- ref name= "security"> < /interosptor- re 人 > 
< /interceptor- stack> 
< /interceptors> 
< /package> 
< /struts> 


由 于 将 结果 视图 放 在 了 /WEB-INFVisp 目录 下 ,而 不 是 默认 的 /WEB-INF/content 
下 面 ,因此 一 定 要 配置 常量 struts. convention. result. path 。 

代码 12-9 中 还 配置 了 一 个 名 为 zero-notes 的 package, 它 是 从 convention-default 上 
扩展 而 来 的 。 注 意 package 的 名 字 , 在 后 面 为 Action 类 添加 @InterceptorRef 注解 时 要 
用 到 它 。 在 package 中 ,还 配置 了 一 个 用 于 登录 验证 的 拦截 器 。 在 使 用 注解 配置 应 用 程 
序 时 ,拦截 器 的 配置 是 在 struts. xml 中 的 。 在 Action 类 中 , @ InterceptorRef 和 @ 
InterceptorRefs 注解 将 引用 这 些 拦 截 器 。 

3 配置 LognAcion 类 

代码 12-10 给 出 了 利用 Convention plugin 注解 过 的 LoginAction 类 。 

代码 12-10 添加 了 注解 的 LoginAction 类 


Package notes.action; 

import java.util .Map; 

jimport org.apache.struts2.oonvention.annotation. * 7 
import notes.dao.UserDao; 

import notes.dao.impl.UserDacTmpl; 

import notes.model.User; 

import om.opensyrphony .xwork2.* 7 


Puiblic class Ioginacticn extends PctionSupport { 
Private String userName; 
private String password; 
/省略 了 gst 和 set 方 法 


QActicn (value= "login" 


:results= {GResult (neme= "login", locaticre= "login.jsp") 
78Result (name= "success",]ocaticn= "listNotes", type= "chain") } 
) 
Public String execute () throws Exosption { 
UserDao userDao= new UserDacTmpl (); 
User user= userDao.findUser (userName, password) ; 


if(null==user) { 
this.addctionError ("用户 名 或 密码 错误 !"); 
retum LOGIN; 

} 

else{ 


8@Rcticn (value= "logout" 
:results= {GResult (neme= "login", locaticre "login.jsp")} 

) 
public String logout (){ 

ActionContext omtext= ActionContext .getContext () 7 

Map session= context. .getSession(); 

3ession.clear (); 

retum LOGSIN; 


上 述 代 码 分 别 为 LoginAction 的 execute() 方 法 和 logout() 方 法 添加 了 @ Action 注 
解 , 并 利用 @Result 对 每 种 结果 码 注 解 了 对 应 的 结果 视图 。 注 意 ,Action 之 间 的 chain 链 
的 配置 方法 。 

4 配置 NblesAction 类 

代码 12-11 给 出 了 利用 Convention plugin 注解 过 的 NotesAction 类 。 


代码 12-11 添加 了 注解 的 NotesAction 类 


Package notes.action; 


import java.io.* ; 
jimport java.util.* ; 

import notes.dao.NotesDao; 

import notes.dao.impl .NotesDacIrpl; 

import notes model.x ; 

import org.apache.struts2.ServletRcticnContext; 
import org.apache.struts2.convention.annotation.x ; 
jimport om.opensynphony.xwork2. * ; 
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@ParentPackage ("zero- notes") 
@InterosptorRef ("euth") 
Piblic class NotesAction extends ActionSupport { 
private Notes note; 
private List< Notes> notes= new ArrayList< Notes> (); 
private String uploadDir; 
private int noteId; 
private File attadment; 
private String attachmentFi leName; 
private String attachmentContentTypey 
// 省 略 了 get 和 set 方 法 


Racticn (value= "listNotes", interoeptorRefs= 68InterceptorRef ("euth") 
,results= {Result (name= "login", locaticn= "ogin.jsp") 
sResult (neme= "successn locaticre "index.jsp") 
} 
) 
Public String list() { 
NotesDao notesDao= new NotesDaoInpl (); 
notes= notesDao.getAllNotes (); 
retum SUOCESS; 


QActicn (value= "actNote", interceptorRefs= 6InterceptorRef ("auth") 
:Tesults= {8Result (neme= "login", locatico= "login.jsp") 
78Result (neme= "irput" locatiore "post.jsp") 
78@Reeult (neme= "successn looaticre "listNotes", type= "chain") 
} 
Params= {"uploadDir", "uploadFiles"} 
) 
Public String ada() { 
if ( ==note) 
retum INEUT; 
PctionContext. ontext= ActionContext. .getContext (); 
Map session= oontext .getSession(); 
User user= (User) session.get ("User"); 
if (null==user) 
retum IOGIN; 
note.setUser (user); 
if(null!=attachment) 
wload(); 
NotesDao notesDacr new NotesDaoTrpl (); 
notesDao.adcNote (note) ; 
retum SUOCESS; 


acticn (value= "detail", interosptorRefs= 8InterceptorRef ("auth") 
:results= {Result (neme= "login", locaticn= "login.jsp") 
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sResult (neme= "sucoess", locaticre "Getail .jsp") 
} 
Perams= {"uploadDir", "uploadFiles"} 
) 
Public String detail () { 
NotesDao notesDao= new NotesDacTmpl (); 
note= notesDao.getNoteById (noteId) ; 
Teturn SUCCESS; 
} 


private void upload () { 
/* 代码 略 ,请 参照 struts 文 件 上 传 一 章 的 案例 * / 
} 


上 述 代 码 首先 利用 注解 @ParentPackage("zero-notes") 声 明了 NotesAction 类 中 所 
要 引用 的 拦截 器 所 在 的 包 ( 见 struts. xml 中 配置 ), 然 后 利用 注解 @ InterceptorRef 
("auth") 将 所 要 用 到 的 拦截 器 引入 类 中 ,最 后 利用 注解 @InterceptorRef("auth") 为 每 个 
方法 声明 了 拦截 器 引用 。 由 于 auth 拦截 器 在 验证 失败 时 返回 “login” 结 果 码 ,所 以 为 每 
一 个 方法 添加 了 一 个 名 为 login 的 @Result 注解 。 


5 配置 FleDomnloadAcian 类 
代码 12-12 给 出 了 利用 Convention plugin 注解 过 的 FileDownloadAction 类 。 


代码 12-12 添加 了 注解 的 FileDownloadAction 类 


package notes.action; 

import java.io.* ; 

jmport javax.servlet.ServletContext; 

jimport org.apache.struts2.oomvention.annotation. * 
jimport om.opensyrphony .xwork?2.ActionSupport; 


@ParentPackage ("Zero- notes") 

@InterosptorRef ("auth") 

Public class FileDwnloadAction extends ActionSupport { 
private String fileName; // 初 始 的 通过 param 指 定 的 文件 名 属性 
Private String downloadDiry // 下 载 文件 所 在 的 目录 


// 省 略 了 gat 和 set 方 法 


Piblic String getContentDispositicn (){ 
String s; 
"attadment;filename= \""+ getDownloadFileName ()+ \""; 
retum 3; 
} 


Public InputStream getInputStream() throws Exosption { 
/* 代码 略 ,请 参照 struts 文 件 上 传 一 章 的 案例 * / 
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} 


8Rcticn (value= "download", interosptorRefs= 6InterceptorRef ("auth") 
:results= {GResult (neme= "login", locaticone= "login.jsp") 
:BResult (name= "sucoess", type= "streen") 
} 
,params= {"downloadDir", "uploadFi les", "pufferSize", "4096"} 
) 
Public String execute() throws Exoeption { 
Teturn SUOCESS; 
} 


Public String getDownlcadFileName() { 
/* 代码 略 ,请 参照 struts 文 件 上 传 一 章 的 案例 * / 
} 
和 


读者 可 以 参照 NotesAction 类 中 的 注解 分 析 , 自 行 分 析 上 述 代码 中 的 注解。 
同步 训练 


删除 struts. xml 中 与 Action 配置 、Result 映射 和 拦截 器 引用 有 关 的 内 容 , 然 后 利用 
注解 配置 站 内 短信 系统 。 
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1311 JQuery 简介 


JQuery 是 目前 最 为 流行 的 JavaScript 框架 之 一 , 它 允 许 程序 员 使 用 现 有 的 知识 , 例 
如 CSS、HTML、XHTML 以 及 原生 的 JavaScript 直接 操作 页 面 元 素 ,无 须 学 习 
JavaScript 高 级 特性 ,实现 快速 开发 。 

JQuery 强调 写 得 少 , 做 得 多 (write less,do more)。JQuery 提供 了 强大 的 选择 器 , 允 
许 使 用 CSS1 至 CSS3 中 提供 的 几乎 所 有 的 选择 器 ,还 自 定 义 了 一 些 选择 器 。 另 外 ， 
JQuery 封装 了 大 量 与 DOM 有 关 的 操作 ,使 得 程序 员 能 够 轻松 完成 各 种 复杂 的 操作 。 
JQuery 利用 Ajax() 函 数 封装 了 所 有 的 AJAX 操作 ,使 得 程序 员 在 开发 AJAX 操作 时 无 
需 关心 浏览 器 兼容 问题 以 及 XMLHttpRequest 对 象 的 创建 和 使 用 问题 。 利 用 JQuery 编 
写 的 代码 能 够 在 所 有 主流 浏览 器 上 顺畅 运行 。JQuery 修复 了 浏览 器 之 间 的 差异 。 由 于 
JQuery 的 易 扩展 性 ,引发 了 全 球 各 地 的 开发 者 编写 JQuery 的 扩展 插件 ,程序 员 可 以 利用 
这 些 插件 实现 各 种 JavaScript 操作 和 特效 。 

在 编写 本 书 时 ,JQuery 的 最 新 版 本 是 1. 8. 1。 读 者 可 以 从 http://jquery. com/ 下 载 
JQuery 的 最 新 版 本 ,并 将 其 复制 到 自己 的 工程 中 。 


但 12 JQuery 选择 器 


JQuery 中 的 选择 器 继承 了 CSS 的 风格 。 利 用 JQuery 的 选择 器 能 够 方便 、 快 捷 地 找 
到 特定 的 DOM 元 素 , 以 便 对 它们 的 属性 进行 操作 ,或 为 它们 添加 新 的 行为 。 

JQuery 选择 器 分 为 基本 选择 器 .层次 选择 器 ,过滤 选 择 器 和 表单 选择 器 。 

基本 选择 器 是 JQuery 中 最 常用 的 选择 器 , 它 利 用 元 素 的 id、class 和 标签 名 字 来 选择 
DOM 元 素 。 表 13-1 给 出 了 JQuery 中 用 到 的 基本 选择 器 。 


表 13-1 基本 选择 器 


选 择 器 说 明 举 例 
#id 根据 给 定 的 id 选择 元 素 $("#intro") 选 择 id 一 "intro" 的 第 一 个 元 素 
. class 根据 给 定 的 class 选择 元 素 | $(".intro") 选 择 所 有 class 一 "intro" 的 元 素 
element 选择 给 定 元 素 名 的 所 有 元 素 | $("p") 选择 所 有 一 p> 元 素 
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续 表 
选 择 器 说 明 举 例 
关 选择 所 有 元 素 $C"*") 
this 选择 当前 HTML 元 素 $C"this") 


selectorl selector2，…， 


将 多 个 选择 器 组 合成 一 个 $("p,span ") 选 择 所 有 的 一 p> 和 <<span> 元 素 


selectorN 


表 13-1 中 的 $0 〇 函数 是 JQuery 的 选择 器 函数 ,用 于 选择 页 面 中 的 元 素 。 
层次 选择 器 允许 JQuery 根据 DOM 之 间 的 层次 关系 选择 特定 的 元 素 ,例如 兄弟 元 素 
和 后 代 元 素 等 。 表 13-2 给 出 了 JQuery 用 到 的 层次 选择 器 。 


表 13-2 层次 选择 器 


选 择 器 说 明 举 例 
i 选择 parent 元 素 后 所 | $("#test div") 选取 id 为 test 的 元 素 所 包含 
有 的 child 元 素 的 所 有 的 div 子 元 素 


选择 parent 元 素 后 所 
有 的 第 一 级 child 元 素 


选择 在 prev 元 素 后 面 


$("#div_al > input") 选 择 id 为 div_al 的 
div 中 的 所 有 input 元 素 
$(" 井 demo 十 img") 选 在 id 为 demo 元 素 后 面 


$ ("parent > child") 


$ ("prev+next") 


的 next 元 素 的 img 对 象 
Snel 选择 prev 后 面 的 siblings | $(" 井 demo 一 [title]") 选 择 id 为 demo 的 元 素 
虚 元 素 后 面 所 有 带 有 title 属性 的 元 素 


过 滤 选 择 器 通过 特定 的 规则 选择 所 需 的 DOM 元 素 。JQuery 中 的 过 滤 选 择 器 分 为 
基本 过 滤 .内容 过 滤 、 可 见 性 过 滤 、 属 性 过 滤 . 子 元素 过 滤 和 表单 对 象 属性 过 滤 选 择 器 。 
表 13-3 给 出 了 JQuery 中 用 到 的 基本 过 滤 选 择 器 。 


表 13-3 ”基本 过 滤 选 择 器 


选择 器 描述 示例 
:first | 选取 第 一 个 元 素 $ C"trifirst”) 选 取 所 有 tr 元 素 中 的 第 一 个 tr 元 素 
ilast | 选取 最 后 一 个 元 素 $ C"trilast") 选 取 所 有 tr 元 素 中 的 最 后 一 个 tr 元 素 
:even | 选取 索引 是 偶数 的 所 有 元 素 $ ("trieven") 选 取 索 引 是 偶数 的 tr 元 素 
iodd ”| 选取 索引 是 奇数 的 所 有 元 素 $ (vtriodd") 选 取 索 引 是 奇数 的 tr 元素 
:eq(index) | 选取 索引 等 于 index 的 元 素 $ (treq(1) ") 选 取 索 引 等 于 1 的 tr 元 素 
:gtCindex) | 选取 索引 大 于 index 的 元 素 $ Ctrigt(1) ") 选 取 索 引 大 于 1 的 上 元 素 
,ltCindex) | 选取 索引 小 于 index 的 元 素 $C"tmleC1) ?选取 索引 小 于 1 的 tr 元 素 ,等 同 于 
$ ("tr:eq(0) ") 
:header | 选取 所 有 的 标题 无 宗 , 例 如 由， (header") 选 取 网 页 中 所 有 的 hl,h2,h3,… 
+animated | 选取 当前 正在 执行 动画 的 所 有 元 素 | $ ("div:animated") 选 取 正在 执行 动画 的 div 元 素 
注意 : 索引 是 从 0 开始 的 。 


表单 选择 器 是 用 于 获取 表单 的 某 个 或 某 类 型 的 元 素 。 表 单 选择 器 都 是 以 冒号 (":") 


开头 ,例如 : 
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(1) $(";input"); 选择 表单 中 所 有 的 二 input 二 、 志 textarea 过、 一 select 二 和 
二 button 记 元 素 。 
(2) $(" :checkbox"); 选择 表单 中 所 有 的 二 checkbox 一 元 素 。 


1313 常用 的 JQuery 属性 方法 


JQuery 提供 的 属性 方法 允许 程序 员 访问 一 个 元 素 所 有 的 属性 ,包括 CSS 和 样式 属 
性, 并且 能 够 修改 它们 。 常 见 的 属性 方法 如 表 13-4 所 示 。 


表 13-4 常见 的 JQuery 属性 方法 


方 法 描 述 举 例 
addClass() 向 匹配 的 元 素 添加 指定 的 | $ ("p:first"). addClass("intro"): 向 第 一 个 p 元 素 添 加 
类 名 一 个 类 
attr() es $ ("img"). attr("width","180") ; 改变 图 像 的 width 属性 
hasClaee() | 检查 匹配 的 元 素 是 否 拥有 | $ ("pfirst"). hasClass( "intro") :检查 第 一 个 p> 元 
指定 的 类 素 是 否 包 含 "intro" 类 
， 设置 或 返回 匹配 的 元 素 集 | $("p"). html("Hello <b> world</b> 1 : 设置 所 有 
tml() 合 中 的 HTML 内 容 Pp 元 素 的 内 容 
号 var o 一 $(". head"). html(): 获得 id 为 head 的 元 素 的 内 容 
removeAttr() 人 $("p"). removeAttr("id"): 从 任何 p 元 素 中 移 除 id 属性 
sy 从 所 有 匹配 的 元 素 中 删除 | $("p:first"). removeClass("intro") : 移 除 所 有 一 p 二 的 
全 部 或 者 指定 的 类 intro 类 
a $ ("button"). click(functionO{ 
toggleClass() 人 $ ("p"). toggleClass("main”); 
)) : 对 设置 和 移 除 所 有 一 p 志 元素 的 main 类 进行 切换 
二 $(".tip").val("Hello World"): 设置 id 为 tip 的 元 素 的 值 
a 设置 或 返回 匹配 元 素 的 值 | alert( $(", tip"). val())。 获得 id 为 tip 的 元 素 的 值 
hide() 隐藏 被 选 的 元 素 $$("p"). hide() : 隐藏 可 见 的 一 p 二 元 素 
show() 显示 被 选 的 元 素 $("p"). show(): 显示 出 隐藏 的 二 p 二 元 素 


除 上 述 方法 外 ,JQuery 还 提供 了 十 几 个 方法 可 以 为 DOM 元素 添 加 动态 效果 ,读者 
可 以 自行 查阅 JQuery 手册 。 

1314 常用 的 JQuery 事件 方法 

许多 脚本 需要 在 特定 事件 (或 浏览 器 动作 ) 发 生 时 进行 特定 的 处 理 。 

1 文档 加 载 事件 方 法 

$ (document). ready() 是 所 有 事件 方法 中 最 重要 的 一 个 。 该 方法 在 文档 载 人 就 绪 


时 就 对 其 进行 操纵 ,并 调用 执行 它 所 绑 定 的 方法 。 
$ (document). ready() 的 用 法 如 下 : 


$ (dpcument) .ready (functicn (){ 
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/计件 代码 
及 


通常 可 以 简写 为 


$ (fimction () { 
/ 课 件 代 码 
D) 


2 为 DCM 元 素 绑 定 事件 
JQuery 中 可 以 为 DOM 元 素 动态 绑 定 的 事件 有 blur focus focusin ,focusout load、 
resize、scroll 、unload 、click dblclick、 mousedown、 mouseup、 mousemove、 mouseover、 
mouseout .mouseenter .mouseleave, change select ,submit,\ keydown, keypress、 keyup 和 
error 等 。 每 个 事件 方法 的 名 字 表 明了 事件 方法 的 作用 ,在 此 不 青 效 述 。 
代码 13-1 演示 了 如 何 使 用 JQuery 操作 DOM 对 象 。 
代码 13-1 JQuery 综合 应 用 


<html xmlns= "http://www.w3.org/1999/xhtml"> 

<head> 

< meta http- equiv= "Content— Type" content= "text/html; charset= utf- 8" /> 
< title> jquery exanple< /title> 


<style> 
.focus{border:1 solid # FO0; background- color:# FOC;} 
.even{ background— color:# FFF38F} 
.odd{background- color:# FFFFEE; } 
< /style> 
< script sro= js/jquery- 1.8.1.min.js"> < /script> 
< script> 
$ (fnctionO) { 
$0":ingput") ,foous (function(){  // 当 impt 控 件 获得 焦点 时 ,添加 foous 样 式 
$ (this) .actClass ("focus") ; 
)) bhr (fnction0{ // 当 impt 控 件 失去 焦点 时 ,删除 fos 样式 
$ (this) .removeClass ("focus") ; 
D; 


$ (ad) .click (finction 0 { // 为 过 aa 的 按钮 添加 click 事 件 方法 
Var detal=$ ( 啡 Gatalm) .val0;// 获 得 id- catal 输入 框 的 值 
Var deta2=$ ( 啡 data2m .val 0;// 获 得 id- cata2 输 入 框 的 值 
Var result= parselInt (datal)+ FarseInt (Gata2) 
$( 啡 reeultm) .val (result); ”// 将 计算 结果 保存 在 id resut 的 输入 框 中 
Ver history=$ ( 啡 histcry)  // 获 得 id-history 的 table 对 象 
/以 下 代码 用 于 向 table 表 中 动态 添加 一 行 数据 
Ver om$ (Kt </t"); 
ver tdle $ (Kt < /tb "); 
tdl .text (datal) 
wer ti $ (Kt < /tb "); 
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te.text (Gate2) 
Verta5s(<t 中 </t 中 中 ; 
tecB.text (result) 


ICw.SEPend(bdl) 7 
ICw.SEPend (bd2) 7 


$ ("tr:od) .acHrlass ("Oc"); // 为 表 中 的 奇数 行 添加 样式 cda 
$ ("tr:even") .adtclass ("even"); /为 表 中 的 偶数 行 添加 样式 even 
D; 
) 
< /script> 
< /head> 
<body> 
< input type= "text" id-= "datal"/>+ 
< input type= "text" id- "data2"/> 
< input type= "putton" id= "add" value= "="/> 
< input type= "text" id- "result" readonly/> 
<br/> 
< table style= "width:300px; border:" id "history"> 
<tr> 
<th> Data 1< /th> 
< th> Data 2< /th> 
< th> Result< /th> 
</tr> 
< /table> 
< /body> 
< /html> 


代码 13-1 演示 了 利用 JQuery 完成 两 个 数 的 加 法 运算 ,并 将 计算 历史 保存 在 一 个 
table 中 。 图 13-1 所 示 为 上 述 代码 在 浏览 器 中 的 运行 效果 。 


© 3 GUOHfe:/kAQuery/l30html 


[ 因 + Fa 


Data 1 Data 2 


13-1 JQuery 方法 演示 
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132 利用 JQuery 实现 客户 端 验证 


在 Web 开发 时 ,JQuery 的 一 个 重要 作用 就 是 验证 用 户 在 表单 中 的 输入 信息 是 否 符 
合约 束 。 例 如 ,在 前 面 的 同步 训练 中 , 曾 要 求 读者 为 留言 板 程序 添加 一 个 注册 页 面 ,并 利 
用 Struts 2 提供 的 验证 框架 对 用 户 信息 进行 验证 。 在 实际 的 开发 中 ,对 于 一 些 不 会 引发 
安全 问题 的 输入 信息 的 验证 ,会 放 到 客户 端 来 完成 ,这 样 可 以 大 大 减轻 服务 器 的 压力 。 
因此 ,对 于 留言 板 注 册页 面 的 验证 ,可 以 利用 JQuery 来 完成 ,如 代码 13-2 所 示 。 


代码 13-2 ”利用 JQuery 实现 客户 端 验证 


< $@page languager "java" pageFnooding= "GEK"S> 
< %$@taglib uri= "/struts- tags" prefix= "s"%®> 
<HM> 
<HEAD> 
< 了 TTTE> 留言 板 -- 注 册 < /TITIE> 
< META http- equiv= Content- Type oontent= "text/html; charset= gok"> 
< link rel= "stylesheet" type= "text/css" href= "style/main.css"> 
< script type= "text/javascript" src= "js/jquery- 1.7.1.js"> < /script> 
< script languager "javascript"> 
$ (function() { 
$ (# submit") .click (function() { 
Var error= 0; 
if($ (# userName") .val ()=="™") { /* 验证 用 户 名 是 否 为 空 * / 
/* 如 果 不 存 在 userTip 对 象 , 添 加 一 个 ia 为 userTip 的 divx / 


证 (lexist ("userTip")) 
$( 啡 UserName") .after ("< div style= 'color:red'id- "userTip'> 用 户 名 不 能 为 空 !</ 
div> "); 
else /* 存 在 userTip 对 象 , 直 接 显示 * / 
$ ("# userTip") .show()7 
errort +; 
} 
else 


$ ("# userTip") -hide()7 


if($ (# password") .val ()=="™") { /* 验证 密码 是 否 为 空 * / 
证 (lexist ("passwordrip") ) 
$ ( 啡 Fassword) .after ("< div style= 'oolor:red' id 'pesswordrip'> 密 码 不 能 为 空 !< /div 
> 
else 
$ (#4 passwordTip") .show(); 
errort +; 
else 
$ (# passwordrip") -hide (); 
/* 验证 两 次 密码 是 否 一 致 * / 
if($ (# password") .val () !=$ ("# password2") .val ()){ 
if (lexist ("repasswordrip")) 
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S$ ( 啡 Fassawordpm) .after ("< div styler 'color:red' id- 'repasswordrip'> 两 次 密码 不 一 致 < /div 
bai /2 
else 
$ ("# repasswordTip") .show (); 
errort+} 
下 
else 


$ (# TepasswordTip") .hide()7 


if($ (#email") .val (=="™"){ /* 验证 Email 是 否 为 空 * / 
if(!exist ("emailTip")) 
$ ( 啡 emailn) .after ("< div style= 'oolor:red' id ‘amilTip'> < /div> "); 
else 
$ (SemailTip") .show(); 
$( 啡 emailTipm) .text ("Email 不 能 为 空 1"); 
errort+; 
} 
else{ /* 验证 Pmail 是 否 符合 规则 * / 
var Fatten= new Regeyp(/^[\w- J+ (\.[\w- J+)* el+\.)+ [a- 2A- 2]+$/); 
if(!patten.test ($ ( 啡 erail) .val () )&&!exist ("erailTip") ) 
$ (# arail") .after ("< div style= 'oolor:red' ic ‘erailTip'>< /div> "); 
else 
$ (emailTip") .show(); 
$( 啡 emailTip") .text ("不 符合 Ere 庆 规则 !"); 
errort +; 


if(error> 0) /* 错误 数 超过 1 处 ,返回 false, 禁 止 将 请 求 发 给 服务 端 * / 


D) 
D) 
/* 判断 是 否 存 在 某 个 刘 值 的 pM 元 素 * / 
fancticn exist (id) { 
if($(# "id) .length> 0){ 
retum true; 


<div class= "header"> 
< /div> 


< 上 -- 用 户 注册 表单 ee 
< font color= "red"> < s:fielderror/>< /font> 
< s:form namer "regForm' action= "register.action" method= "post" theme— 
"simple" namespacer "/"> 
<div class= "coll" style- "width:400ps;"> 用 户 名 < /div> 
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<div class= "co12"> 
<s:textfield name= "userName" label]=" 用 户 名 " cssclass= "input" id= 
muserNamer> < /s:textfield> 
</div> 
<div class= "clear"/> 
<div class= "coll" styler "width:400ps; 吃 密码 < /div> 
<div class= "co12"> 
< s:password name= "password" labe]= 哈 ” 码 " cssclass="input" id= 
"password"> < /s:password> 
</div> 
< div class= "clear"/> 
<div class= "coll" style= "width:400px;"> 重 复 密码 < /div> 
< div class= "co12"> 
< s:Fassword nene= "Fasswordp" label= 嘲 复 密 码 " cssclass="irput" ij 中 
"Easswordp"> < /s:password> 
</div> 
<div class= "clear"/> 
< div class= "coll" style= "width:400p%; "> Email< /div> 
<div class= "co012"> 
< 3:textfield namer "email" id- "email"> < /s:textfield> 
</div> 
<div class= "clear"/> 
< div class= "coll" style= "width:400px; "> 性别 < /div> 
<div class= "co12"> 
<s:radio list= 啡 {1:" 男 .0:'" 女 J" label= "性 别 " name="gender" value= 
></s:radio> 
</div> 
<div class= "clear"/> 
< div class= "coll" style= "width:400px;"> 
请 选择 头像 
</div> 
<div class= "col2"> 
<s:radio list= 啡 {"1.gif':'< img src= images/head/1.gif > ', 
'2.gif':'< img src= imges/head/2.gif> ', 
'3.gif':'< img sro- imges/head/3.gif> ', 
"4.gif':'< img sro- imges/head/4.gif>' 
}"name= "head" value=""1.gif'"> < /s:radio> 
</div> 
<div class= "clear"/> 
<div class= "co011"> < /div> 
<div class= "col2"> 
< s:submit cssclass= "btn" value=" 福 册 " ic "suimit"> < /s:suitmit> 
</div> 
< /s:fom> 
< /BODY> 
< /HM> 


在 代码 13-2 中 ,一 旦 发 现 某 个 表单 项 的 信息 输入 不 符合 程序 约束 ,就 利用 JQuery 在 
该 表单 项 之 后 添加 一 个 div 标签 ,显示 错误 信息 提示 ,同时 利用 一 个 变量 error 对 错误 计 
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数 。 当 error 不 为 0 时 ,submit 的 click 事件 方法 返回 false, 从 而 阻止 浏览 器 将 请 求 提交 
给 Web 服务 器 。 
代码 13-2 在 浏览 器 中 的 运行 情况 如 图 13-2 所 示 。 


图 13-2 利用 JQuery 实现 注册 信息 的 客户 端 验证 


133 利用 JQuery 实现 AJAX 


1331 JSCN 


JSON(JavaScript Object Notation) 是 一 种 轻 量 级 的 数据 交换 格式 。 在 AJAX 开发 
时 ,通常 利用 JSON 作为 Web 服务 器 和 JavaScript 之 间 交 换 数 据 的 格式 。 

JSON 支持 两 种 结构 。 

(1) “名称 / 值 ”对 的 集合 ,可 以 理解 成 高 级 语言 中 的 对 象 (object) .记录 (record) 、 结 
构 (struct)、 哈 希 表 (hash table) 和 有 键 列表 (keyed list) 等 。 在 这 种 结构 中 ,对 象 是 一 个 
无 序 的 “name/value” 集 合 。 对 象 以 “{”( 左 括号 ) 开 始 ,“)”( 右 括号 ) 结 束 。 每 个 name 后 
跟 一 个 “ :”( 冒 号 ) 。 两 个 “name/value” 之 间 使 用 ,”( 逗 号) 分隔 。 例 如 : 


{"userleme": "zhengsan", nearailwsnzhangsan8163.catv "age":30, "terriage":false} 

这 里 的 value 也 可 以 是 一 个 Object 或 者 数组 。 例 如 , 某 个 Person 对 象 包括 
UserName 和 address 两 个 对 象 ,而 address 又 由 对 象 city street 和 ZIP 构成 ,可 以 写成 
如 下 形式 。 

{"userName":"zhangsan", "address": {"city":"BeiJing", "street":"NanJing Road", "ZIP":100000}} 

(2) 值 的 有 序列 表 , 可 以 理解 为 高 级 语言 中 的 数组 (array)。 当 需要 表示 一 组 值 时 ， 
JSON 不 但 能 够 提高 可 读 性 ,而 且 可 以 减少 复杂 性 。 例 如 ,对 于 一 个 名 为 student 的 变 
量 , 值 是 包含 三 个 条 目的 数组 ,每 个 条 目 是 一 个 人 的 记录 ,包含 姓名 、 年 龄 和 E-mail 地 址 ， 
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可 以 写成 如 下 形式 。 


{ "student": [ 
{ "name": " zhangsan ", "age":21, "email": "zhangsan@163.0m" }, 
{ "name": "isi", "age":20, "email": "isi@sina.oom" }, 
{ "name": "wangwu", "age":19, "email": "wang@hotmail.oom" } 

]} 


1332 JQuery 的 和 AX 方法 


除了 完成 DOM 操作 和 输入 验证 外 ,JQuery 还 提供 了 一 套 完整 的 AJAX 函数 和 方 
法 ,使 得 程序 员 能 够 很 方便 地 开发 AJAX 应 用 。 表 13-5 给 出 了 所 有 JQuery 提供 的 


AJAX 函数 和 方法 。 
表 13-5 AJAX 函数 和 方法 
函 数 说 明 
jQuery. ajax() 执行 异步 HTTP(AJAX) 请 求 
jQuery. ajaxSetup() ”| 设置 将 来 的 AJAX 请 求 的 默认 值 
jQuery. get() 使 用 HTTP GET 请 求 从 服务 器 加 载 数据 


jQuery. getJSONO 使 用 HTTP GET 请 求 从 服务 器 加 载 JSON 编码 数据 
jQuery. getScript() 使 用 HTTP GET 请 求 从 服务 器 加 载 JavaScript 文件 ,然后 执行 该 文件 


.load() 从 服务 器 加 载 数 据 , 然 后 返回 到 HTML 放 入 匹配 元 素 

jQuery. param() 创建 数组 或 对 象 的 序列 化 表示 ,适合 在 URL 查询 字符 串 或 AJAX 请 求 中 使 用 
jQuery. post() 使 用 HTTP POST 请 求 从 服务 器 加 载 数据 

. Serialize() 将 表单 内 容 序列 化 为 字符 串 


.serializeArray() 序列 化 表单 元 素 ,返回 JSON 数据 结构 数据 


除 上 述 方法 外 ,JQuery 还 提供 了 一 些 AJAX 事件 ,允许 程序 员 在 AJAX 处 理 前 后 做 
一 些 附加 的 操作 ,例如 捕捉 AJAX 错误 .AJAX 请 求 成 功 提示 等 ,如 表 13-6 所 示 。 
表 13-6 AJAX 事件 


事 件 说 明 
.ajaxComplete() 当 AJAX 请 求 完成 时 ,注册 要 调用 的 处 理 程序 
.ajaxError() 当 AJAX 请 求 完成 且 出 现 错误 时 ,注册 要 调用 的 处 理 程序 
.ajaxSend() 在 AJAX 请 求 发 送 之 前 显示 一 条 消息 
.ajaxStart() 当 首 个 AJAX 请 求 完 成 开始 时 ,注册 要 调用 的 处 理 程序 
.ajaxStop() 当 所 有 AJAX 请 求 完成 时 ,注册 要 调用 的 处 理 程序 
.ajaxSuccess() 当 AJAX 请 求 成 功 完成 时 ,显示 一 条 消息 


下 面 举 一 个 例子 ,演示 利用 JQuery 的 load() 方 法 ,将 服务 器 上 的 load. html 文件 动 
态 加 载 到 当前 页 面 的 div 中 ,如 代码 13-3 所 示 。 


代码 13-3 load() 方 法 的 用 法 
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< html xmlns- "http://www.w3.org/1999/xhtml"> 
<head> 
<meta http- eqyiv= "Content- Type" content= "text/html; charset= utf- 8" /> 
<title> load 函数 < /title> 
< script sro= "js/jquery- 1.8.1.min.js"> < /script> 
< script> 

$ (fumcticn () { 

$ (# expend") .click (function(){ 
$ (W# oontent") .load ("load.html", fincticn(){ 
$ (3 content") .fadeIn('slow'); 
Ds; 
Ds; 

)) 
< /script> 
< /head> 
<body> 

< input type= "button" idF "expand" value= "expand"/> <br/> 

<div id- "ontent">< /div> 
< /body> 
</htm> 


上 述 代码 在 Chrome 5 浏览 器 中 无 法 加 载 load. html, 因 为 Chrome 5 对 非 针 对 服务 
端的 AJAX 调用 做 了 严格 的 限制 。 代 码 13-3 在 Firefox 浏览 器 中 的 运行 效果 如 图 13-3 
所 示 ,图 中 显示 为 单 击 expand 按钮 后 的 页 面 。 
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用 法 
1oad() 方法 通过 AJAX 请 求 从 服务 器 加 载 数据 ， 并 把 返回 的 数据 放置 到 指定 的 元 素 中 。 
参数 撕 述 
er _| 疯 定 要 将 请 求 发 丢 到 哪个 RL、 | 
a 同 迁 。 欧 定 连 所 请求 发 这 到 服务 吉 玖 数据 - | 
[可 选 。 规 定 当 请 求 完成 时 运行 的 活 数 。 | 
| 咕 外 的 参数， 
janetionresponse, srarus ar 由 os 二 生计 天 半 下 的 拉 末 雪 据 。 
notmodified" “error”，“tineout” 息 | 
“parsererror” | 
。 zhr - 包含 JILHttpRequest 对 得 | 


图 13-3 load() 方 法 运行 效果 


load() 方 法 只 能 从 服务 器 上 获取 静态 文件 。 如 果 和 希望 获取 动态 数据 ,可 以 使 用 get() 
或 post() 方 法 。 
get() 方 法 的 结构 如 下 : 
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$ (selector) .get (url,data, function (response, status, xhr) ,dataType) 


其 中 ,dataType 为 务 器 响应 的 数据 类 型 ,可 以 为 xml、html,text 和 JSON 等 数据 类 
型 ,其 余 各 参数 的 含义 与 load() 方 法 相同 。 

post() 方 法 的 结构 和 使 用 方式 与 get() 方 法 是 一 样 的 ,分 别 对 应 HTTP 的 GET 操作 
和 POST 操作 ,在 此 不 再 赣 述 。 
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在 基于 Struts 2 的 Web 开发 中 ,可 以 利用 JQuery 调用 Action 类 完成 某 项 处 理 , 并 
将 处 理 的 结果 利用 JSON 返回 给 页 面 。 

下 面 通过 一 个 例子 详细 讨论 如 何 实现 Struts 2、JQuery 和 JSON 的 整合 。 该 例子 演 
示 了 在 Web 应 用 程序 注册 新 用 户 时 ,输入 用 户 名 后 ,浏览 器 会 利用 AJAX 技术 查询 该 用 
户 名 是 否 已 经 存在 。 


1 整合 Sruts 2.JQery 和 JSCN 时 所 需要 的 JAR 

在 整合 Struts 2.JQuery 和 JSON 时 ,除了 需要 导入 4. 2. 1 小 节 提 到 的 7 个 基本 JAR 
包 外 ,还 需要 导入 json_simple-x. x. jar 和 Struts 2-json-plugin-x. x. x. jar。 

json_simple-x. x. jar 是 一 个 简单 的 Java 类 库 ,用 于 解析 和 生成 JSON 文本 。 该 类 库 
提供 的 JSONValue、JSONObject、JSONArray 等 类 ,为 在 Java 应 用 程序 中 处 理 各 种 数据 
类 型 JSON 的 数据 提供 了 便利 。 由 于 json_simple-x. x. jar 在 实现 时 不 依赖 于 其 他 类 库 ， 
因此 性 能 比较 高 。 

Struts 2-json-plugin-x. x. x. jar 是 Struts 2 提供 的 JSON 插件 ,定义 了 用 于 响应 客户 
端 请 求 的 JSONResult 结果 类 型 ,以 及 读 写 JSON 的 JSONReader 和 JSON Writer 等 类 。 


2 编写 Aciom 类 

代码 13-4 给 出 了 检查 用 户 名 是 否 已 经 存在 的 Action 类 , 它 与 普通 的 Action 类 基本 
类 似 ,不 同 的 是 在 该 类 的 execute() 等 方法 中 通常 只 需要 返回 SUCCESS 结果 码 。 该 类 提 
供 了 一 个 result 属性 ,用 于 向 客户 端 返回 一 个 JSON。 由 于 result 仅仅 返回 一 个 字符 串 ， 
所 以 只 需 提 供 getter 方法 即 可 ,不 需要 额外 的 处 理 。 


代码 13-4 用 于 返回 JSON 数据 的 Action 类 


package notes.action; 

import notes.dao.UserDao; 

import notes.dao.inpl .UserDaoTrpl; 

jimport om.cpensyrphony .xwork?2.ActionSupport; 

Public class ValidUserAction extends ActionSupport{ 
Private String userName; 
private String result; // 用 于 返回 结果 
// 省 略 了 getter 和 setter 方 法 


Public String execute () throws Esception { 
UserDao userDao= new UserDaoImpl () > 
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if (userpao.findJser (userNeme)==null1) 
result=" 用 户 名 可 用 !"; 

else 
result=" 用 户 名 已 经 存在 !"; 


Ietum SUOCESS; 


3 编写 JS 脚本 

JQuery 中 常用 getJSON 来 调用 并 获取 远程 的 JSON 字符 串 ,将 其 转换 为 JSON 对 
象 。 如 果 成 功 , 则 执行 回调 函数 。 

代码 13-5 在 userName 输入 框 的 blur() 方 法 中 ,通过 getJSON() 方 法 调用 了 服务 器 
端的 validUser. action 实例 ,同时 将 用 户 名 传递 给 Action 类 的 userName 属性 ,并 在 成 功 
获得 响应 后 ,将 返回 的 JSON 数据 (存放 在 result 中 ) 添 加 到 一 个 div 中 。 请 注意 
getJSONQO 〇 方法 的 第 二 个 参数 ,该 参数 为 发 送 到 服务 器 端的 数据 ,其 格式 必须 是 JSON 支 
持 的 两 种 格式 之 一 。 当 需要 将 表单 中 输入 的 所 有 数据 都 发 送 到 服务 器 端 时 ,也 可 以 直接 
使 用 JQuery 提供 的 序列 化 函数 , 形 如 $("#form1l1"). serialize()。 


代码 13-5 通过 JQuery 调用 Action 类 的 JS 文件 


$ (functicn (){ 
$ ( 啡 userNamen) .blur (functicn (){ 
$.getJSCN ("validUser.acticn", // 后 台 处 理 程序 
{userNeme:$ ( 啡 userNeme") .val()}，  // 要 传递 的 数据 
finction (result) { // 回 调 函 数 
Var tip= "< div style= 'color:red'id= 'userTip'> "+ resultt "/< div> " 
if (lexist ("userTip")) /# 若 不 存在 userTip 的 div, 则 添加 一 个 */ 
$ (4 userNeme") .after (tip); 
else{ /* 存在 userTip 对 象 , 直 接 显示 * / 
$ (# userTip") .html (tip); 
$ (# userTip") .show(); 
} 
D; 
D) 
D); 
4 编写 rusxml 


在 整合 JSON 时 ,所 有 返回 JSON 数据 的 Action 类 必须 配置 在 扩展 自 json-default 
的 package 中 。 另 外 ,Struts 2 提供 的 JSON 插件 Struts 2-json-plugin-x. x. x. jar 中 定义 
了 一 个 用 于 响应 客户 端 请 求 的 json 结果 类 型 ,必须 为 Action 类 中 配置 该 结果 类 型 。 

代码 13-6 给 出 了 ValideUser. action 的 配置 ,注意 ,JSON 返回 类 型 中 的 参数 root 指 
出 了 用 户 返 回 JSON 数据 的 Action 属性 。 


代码 13-6 struts. xml 
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<struts> 
< package name= "default" namespace= "/" extends= json- default"™> 
< action name= "validUser" class= "notes.action.ValidJserActicon" > 


1334 调用 Acio 返回 List 

在 整合 Struts 2.JQuery 和 JSON 时 ,除了 通过 Action 类 返回 一 个 字符 串 ,还 可 以 返 
回 一 个 List。 

下 面 举 一 个 例子 ,利用 JQuery 调用 Action 类 获取 所 有 的 留言 信息 。 

1 编写 Acio 类 

代码 13-7 给 出 了 返回 所 有 留言 信息 的 Action 类 。 


代码 13-7 ListNotes. Action 类 


piblic class ListNotesAction extends ActionSupport { 
Private List< Notes> notes; 
/| 省 略 了 getter 和 setter 方 法 


由 上 述 代码 可 以 看 出 ,在 集成 JQuery 和 Struts 2 时 ,返回 List 的 Action 类 的 写法 与 
以 前 学 到 的 内 容 没有 区 别 。 


ListNotes. Action 类 在 struts. xml 中 配置 的 方法 与 13. 3. 3 小 节 类 似 , 读 者 可 仿照 
代码 13-6 操作 。 

2 编写 页 面 文 件 list\btesjsp 

本 节 将 使 用 JQuery 的 ajax() 方 法 完成 对 Action 类 的 访问 。ajax() 方 法 是 最 底层 的 
AJAX 实现 ,通常 情况 下 ,用 户 只 需 使 用 前 面 提 到 的 get()、post() ,load()、getJSON() 和 
getScript() 等 方法 完成 AJAX 操作 ,但 是 有 时 出 于 灵活 性 考虑 ,也 会 用 到 ajax() 方 法 。 


第 13 剖 整合 JQuery < 


ajax() 方 法 只 有 一 个 可 选 的 参数 ,该 参数 的 值 是 一 个 “名 称 / 值 ” 对 的 集合 ,包含 了 所 
需要 的 请 求 设置 以 及 回调 函数 等 。 集 合 中 的 每 一 个 设置 参数 都 是 可 选 的 。 表 13-7 给 出 
了 常用 的 设置 参数 。 


表 13-7 ajax() 方 法 的 参数 中 常用 的 设置 


事 件 类 型 说 明 
url String 用 于 处 理 请 求 的 地 址 。 默 认 值 为 当前 页 面 的 地 址 
type String 请 求 方式 ,可 选 值 post 和 get。 默 认 值 为 post 


发 送 到 服务 器 的 数据 ,将 自动 转换 为 请 求 字符 串 格式 。GET 请 求 中 将 附加 
Object 在 URL 后。 必须 为 Key/Value 格式 。 如 果 为 数组 ,JQuery 将 自动 为 不 同 
或 String | 值 对 应 同一 个 名 称 。 例 如 , {foo: ["barl"，"bar2"]} 转换 为 '&foo 一 
barl&foo 一 bar2' 


期 望 服 务 器 返回 的 数据 类 型 。 可 用 值 为 : 

。 xml: 返回 XML 文档 ,可 用 JQuery 处 理 

。 html: 返回 纯 文本 HTML 信息 ;包含 的 Script 标签 会 在 插入 DOM 时 执行 

。 script: 返回 纯 文本 JavaScript 代码 。 不 会 自动 缓存 结果 ,除非 设置 了 
"cache" 参 数 。 注 意 : 在 远程 请 求 时 (不 在 同一 个 域 下 ), 所 有 POST 请 求 

dataType String 都 将 转 为 GET 请 求 

json: 返回 JSON 数据 

jsonp: JSONP 格式 。 使 用 JSONP 形式 调用 函数 时 ,如 "myurl?callback 一 ?"， 

JQuery 将 自动 替换 “?” 为 正确 的 函数 名 ,以 执行 回调 函数 

。 text: 返回 纯 文本 字符 串 

缺 省 时 ,JQuery 会 自动 根据 HTTP 包 MIME 信息 来 智能 识别 

在 发 送 请 求 前 执行 ,可 修改 XMLHttpRequest 对 象 的 函数 。 有 唯一 的 参 

数 : XMLHttpRequest 对 象 


请 求 完成 后 的 回调 函数 (请 求 成 功 或 失败 之 后 均 调 用 )。 有 唯一 的 参数 : 
XMLHttpRequest 对 象 

请 求 成 功 完成 后 的 回调 函数 ,包括 两 个 可 选 参 数 : 

success Function | 。 服务 器 返回 的 数据 ,类 型 取决 于 dataType 设置 

。 描述 状态 的 字符 串 

请 求 失败 后 的 回调 函数 ,包括 三 个 参数 : XMLHttpRequest 对 象 .错误 对 象 
和 捕获 错误 的 对 象 

global Boolean | 是 否 触发 全 局 AJAX 事件 。 默 认 值 为 true 


data 


beforeSend | Function 


complete Function 


error Function 


在 代码 13-8 中 给 出 的 页 面 文件 利用 ajax() 方 法 实现 了 对 Action 类 的 调用 。 
代码 13-8 ”页 面 文件 listNotes. jsp 


< S$@page language= "java" PageEncoding= "UTF- 8"%> 
<html> 
<head> 
<title> 留 言 板 -- 列 表 < /title> 

< script type= "text/javascript" src= "js/jquery- 1.8.1.js"> < /script> 
< script language= "javascript"> 

$ (fnction() { 

S$.ajax({ 
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type: "post", //post 方 式 

dataType: son", // 返 回 数据 类 型 为 50N 数 据 格式 
wrl:"istNotes.acticon", // 所 调用 的 acticn 名称 
Success:functicn (data) { 

// 使 用 jQuery 中 的 each datafumcticn01)); 函 数 

// 从 data 获 取 Notes 对象 放 入 note 之 中 

$ each (data, fumcticn (i,note) { 


$( 叶 message") .append("< div> 第 叶 (二)+ 吧 留言 ;</div> ") 
.append ("< div style= 'color:red'> 留 言 人 : 
叫 note.user .userNemet "< /div> ") 
.append ("< div style= 'color:red'> 主题 : +note.titlet "< /div> ") 
.aFpend ("< div style= 'color:red'> 内 容 : "+ note.contentt "< /div> "); 
D; 
} 
D; 
}) 
< /script> 
< /head> 
<body> 
< div id "message"> < /div> 
< /body> 
< /hbml> 


代码 13-8 中 ,在 ajax() 的 success 函数 中 使 用 each() 方 法 对 接收 到 的 List 进行 了 遍 
历 。 图 13-4 给 出 了 listNotes. jsp 页 面 的 运行 情况 。 


园 留言 板 - 列 表 
和 CGI12700.1680 


法 的 使 用 
) 方法 在 AJAX 请 求 成 功 时 执行 函数 。 它 是 一 个 Ajax 事件 


图 13-4 ”listNotes. jsp 运行 效果 


同步 训练 


修改 站 内 短信 ,利用 JQuery 实现 下 述 功 能 。 
(1) 添加 短信 删除 功能 。 
(2) 为 编写 短信 添加 保存 到 草稿 箱 的 功能 。 


附录 A MyEelipse 常用 的 快捷 键 


1 编辑 常用 快捷 键 

Ctrl 十 S 保存 快捷 键 

Ctrl 十 D 删除 当前 行 

Ctrl 十 Shift 十 F 格式 化 代码 

Ctrl 十 / 注释 或 者 取消 注释 选中 行 (或 鼠标 所 在 行 ) 
Ctrl 十 Shift 十 X 所 选 字符 转换 为 大 写 

Ctrl 十 Shift 十 Y 所 选 字符 转换 为 小 写 

Ctrl 十 Shift 十 y 复制 当前 行 

Ctrl 十 Shift 十 P 查找 与 当前 内 容 相 匹配 的 内 容 ( 例 如 括号 的 匹配 ) 
2 内 容 提 示 快 捷 键 

Ctrl 十 1 提示 如 何 修正 错误 ,可 实现 重 命名 
Ctrl 十 Shift 十 O 自动 导入 所 有 未 导入 的 包 或 类 

Ctrl 十 Shift 十 M 导入 光标 所 在 行 的 未 导入 的 类 或 包 
Alt 十 / 内 容 辅助 ,自动 补 全 

Ctrl 十 TCF4) 显示 类 结构 

Ctrl 十 OCF3) 显示 类 中 方法 和 属性 大 纲 

3 重 构 快捷 键 

Alt 十 Shift 十 R 重 命名 

Alt 十 Shift 十 M 抽取 方法 

Alt 十 Shift 十 C 修改 函数 结构 

Alt 十 Shift 十 L 抽取 本 地 变量 

Alt 十 Shift 十 F 把 Class 中 的 local 变量 变 为 field 变量 
Alt 二 Shift 十 I 合并 变量 (可 能 这 样 说 有 点 不 妥 Inline) 
Alt 十 Shift 二 V 移动 函数 和 变量 

Alt 十 Shift 十 Z 撤销 重 构 


1 旦 表达 式 简介 

EL(Expression Language) 提 供 了 在 JSP 中 简化 表达 式 的 方法 , 它 允 许 在 脚本 编制 
元 素 范 围 外 使 用 运行 时 表达 式 。 所 谓 的 脚本 编制 元 素 ,是 指 页 面 中 能 够 用 于 在 JSP 文件 
中 入 入 Java 代码 的 元 素 。 它 们 通常 用 于 对 象 操 作 , 以 及 执行 那些 影响 所 生成 内 容 的 计 
算 。 利 用 EL 表达 式 可 以 完成 如 下 功能 。 

(1) 获取 数据 : EL 表达 式 通常 用 来 替换 页 面 中 的 JSP 表达 式 , 可 以 将 各 种 类 型 的 
Java 对 象 的 值 输出 到 JSP 页 面 上 。 

(2) 执行 运算 : 利用 EL 表达 式 , 可 以 在 JSP 页 面 中 执行 一 些 基本 的 关系 运算 、 人 逻辑 
运算 和 算术 运算 ,以 在 JSP 页 面 中 完成 简单 的 多 辑 运 算 。 

(3) 获取 Web 开发 常用 对 象 : EL 表达 式 语 言 中 定义 了 11 个 隐 含 对 象 ,使 用 这 些 隐 
含 对 象 可 以 很 方便 地 获取 Web 开发 中 的 常见 对 象 ,并 读 取 这 些 对 象 的 数据 。 

(4) 调用 Java 方法 : 在 JSP 页 面 中 ,通过 EL 表达 式 可 以 调用 Java 类 的 方法 。 

2 旦 语法 规则 

调用 EL 表达 式 的 一 般 格式 如 下 : 

$ {expression} 

注意 : $ 和 {} 不 要 漏 写 , 它 是 组 成 EL 表达 式 不 可 缺少 的 一 部 分 。 

EL 表达 式 语句 在 执行 时 会 调用 pageContext. findAttribute() 方 法 ,用 标识 符 为 关键 
字 , 将 按照 page~>request~>session~>application 的 顺序 查找 相应 的 对 象 。 找 到 , 则 返回 
相应 对 象 ; 找 不 到 , 则 返回 ""。 

利用 EL 表达 式 还 可 以 很 方便 地 获取 JavaBean 的 属性 ,或 者 获取 数组 、Collection、 
Map 类 型 集合 的 数据 ,例如 : 


$ {notes.user.userName} 


$ {notes. 1ist [0]} // 访 问 有 序 集合 某 个 位 置 的 元 素 
$ fmap.key} // 获 得 mep 集合 中 指定 key 的 值 
3 [与 . 运算 符 


EL 提供 “. ”和 “[]” 两 种 运算 符 来 存 取 数 据 。 
当 要 存 取 的 属性 名 称 中 包含 一 些 特殊 字符 ,如 “. ”或 “?” 等 并 非 字母 或 数字 的 符号 ， 
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一 定 要 使 用 “[]”。 例 如 ,$ {user. My-Name} 应 当 改 为 $ {user["My-Name"]}。 
如 果 要 动态 取 值 ,可 以 用 “[]” 来 完成 .而 “. ”无 法 做 到 动态 取 值 。 例 如 , $ {sessionScope. 
user[ data]) 中 的 data 是 一 个 变量 。 


4 旦 表达 式 中 的 隐 含 对 象 
EL 表达 式 提供 了 11 个 隐 含 对 象 , 用 于 访问 JSP 中 的 常用 对 象 ,如 表 B-1 所 示 。 访 
问 隐 含 对 象 的 语法 为 : 


${ 隐 式 对 象 名 称 } 


表 B-1 EL 表达 式 中 的 隐 含 对 象 
隐 含 对 象 名 称 描 述 
pageContext 表示 当前 页 面 的 Javax. servlet. jsp. PageContext 对 象 
pageScope 表示 page 域 中 用 于 保存 属性 的 Map 对 象 
requestScope 表示 request 域 中 用 于 保存 属性 的 Map 对 象 
sessionScope 表示 session 域 中 用 于 保存 属性 的 Map 对 象 
applicationScope | 表示 application 域 中 用 于 保存 属性 的 Map 对 象 


param 表示 保存 了 所 有 请 求 参 数 的 Map 对 象 

paramValues 表示 保存 了 所 有 请 求 参数 的 Map 对 象 。 对 于 某 个 请 求 参数 ,返回 的 是 一 个 string[] 
header 表示 保存 了 所 有 http 请 求 头 字段 的 Map 对 象 

headerValues 表示 保存 了 所 有 http 请 求 头 字段 的 Map 对 象 ,返回 string[] 数 组 

cookie 表示 保存 了 所 有 cookie 的 Map 对 象 

initParam 表示 保存 了 所 有 web 应 用 初始 化 参数 的 Map 对 象 


5 使 用 旦 调用 Jaa 方 法 
EL 表达 式 语法 允许 程序 员 开 发 自 定义 函数 ,以 调用 Java 类 的 方法 。 格 式 如 下 : 


$ {prefix: method (params)} 


注意 : 在 EL 表达 式 中 调用 的 只 能 是 Java 类 的 静态 方法 ,并 且 这 个 Java 类 的 静态 方 
法 需要 在 TLD 文 件 中 描述 , 才 可 以 被 EL 表达 式 调用 。 
下 面 给 出 一 个 自 定义 EL 函数 的 例子 ,Java 代码 如 下 ， 
import Java.net.URLEncoder; 
Public class MyFELTag { 
Public static String myString (String str) { 
String deoodeStr= "["+ str+ "]"; 
retum deoodeStr; 


1 


为 了 在 EL 表达 式 中 调用 该 函数 ,需要 首先 为 其 配置 TLD 文件 。 为 此 ,在 WebRoot\ 
WEB-INF 目录 下 面 建立 一 个 myTag. tld 文件 ,内 容 如 下 : 
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< Zl Versior= "1 .0" enooding= "UIF- 8"2> 
< taglib xmlns= "http://Java.sun.om/xml/ns/j2ee" 

mlns:xsi= "http://www-w3-org/2001/XMLSchema instanoe" 

Zi: shemelocatim = "http://Java. sn. camlUns/j2ee http://Java. smn. om/xml /ns/j2ee/web — 
jsptaglibrary 2 0-xsan 

version= "2.0"> 

<tlib- version> 1.0< /tlib- version> 

< short- name> el< /short- name> 
< finction> 
< 上 -对 这 个 本 方法 的 描述 --> 

< description> calculate string length< /description> 

< name> FunctionsEl< /name> < !-- 调 用 开 方 法 的 名 称 一 > 

< function- class> camel.code.FuncticnsEl< /function- class> 


< finction- signature> 
Java. lang.String elEnoode (Java. lang.String) 
< /function- signature> 
< exanple> $ {el:FuncticnsEl (str) }< /exarple> < !-- 例 如 --> 
< /function> 
< /taglib> 


以 后 就 可 以 在 JSP 页 面 采用 下 面 的 方式 使 用 EL 表达 式 引用 自 定义 函数 。 


< %@taglib prefix= "el" uri= "/WEB- INE/myTag.tld"s> 
$ {el myString ("Hello World!") } 


6 旦 表达 式 与 Srus 2 

尽管 在 Struts 2 框架 中 将 application 和 session 等 对 象 进 行 了 包装 ,仍然 可 以 利用 
EL 表达 式 来 完成 对 这 些 对 象 的 存 取 。 

例如 ,在 一 个 Action 类 的 execute() 方 法 中 具有 如 下 代码 。 

ActionContext. context= Rctioncontext.getContext (); 

Map sessicn= oontext .getSession(); 

Map application= ontext .getApplication(); 

session.put ("user", "zhangsan") ; 

application.put ("weloome", "欢迎 登录 留言 板 "); 


message= "Hello World!"; //message 是 action 类 的 属性 
则 在 对 应 的 JSP 页 面 中 ,可 以 使 用 下 述 代码 完成 对 session application 和 Action 类 的 属 
性 的 存 取 。 


Session:$ {session.user} <br/> 
Deplication:$ {application.user2 } <br/> 
message:$ {message }<br/> 

who:$ {who} 
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